You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@community.apache.org by gi...@apache.org on 2023/08/16 20:16:14 UTC
[comdev-site] branch asf-site updated: Updated asf-site from main at c9245047a72470f2a1979da27c10c354da157f76
This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/comdev-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new bc55c9b Updated asf-site from main at c9245047a72470f2a1979da27c10c354da157f76
bc55c9b is described below
commit bc55c9b909bf5e18ac9fdd57837e70743e33b416
Author: jenkins <bu...@apache.org>
AuthorDate: Wed Aug 16 20:16:11 2023 +0000
Updated asf-site from main at c9245047a72470f2a1979da27c10c354da157f76
Built from https://ci-builds.apache.org/job/Community%20Development/job/site/job/main/65/
---
content/_pagefind/fragment/en_a0237e1.pf_fragment | Bin 3093 -> 0 bytes
content/_pagefind/fragment/en_f52d10b.pf_fragment | Bin 0 -> 3448 bytes
content/_pagefind/index/en_25c7fdb.pf_index | Bin 0 -> 35980 bytes
content/_pagefind/index/en_3610413.pf_index | Bin 0 -> 38866 bytes
content/_pagefind/index/en_4472174.pf_index | Bin 0 -> 35818 bytes
content/_pagefind/index/en_4b64e57.pf_index | Bin 0 -> 40171 bytes
content/_pagefind/index/en_56a3c02.pf_index | Bin 7117 -> 0 bytes
content/_pagefind/index/en_6685b3f.pf_index | Bin 35853 -> 0 bytes
content/_pagefind/index/en_67532e3.pf_index | Bin 38773 -> 0 bytes
content/_pagefind/index/en_7d87712.pf_index | Bin 0 -> 7387 bytes
content/_pagefind/index/en_b25d232.pf_index | Bin 36092 -> 0 bytes
content/_pagefind/index/en_b694de7.pf_index | Bin 36607 -> 0 bytes
content/_pagefind/index/en_ba923ee.pf_index | Bin 40070 -> 0 bytes
content/_pagefind/index/en_c3e3eec.pf_index | Bin 0 -> 36554 bytes
content/_pagefind/pagefind-entry.json | 2 +-
content/_pagefind/pagefind.en_5b76dae648.pf_meta | Bin 1118 -> 0 bytes
content/_pagefind/pagefind.en_bc3217e276.pf_meta | Bin 0 -> 1127 bytes
content/contributors/mailing-lists.html | 83 +++++++++++++++-------
18 files changed, 57 insertions(+), 28 deletions(-)
diff --git a/content/_pagefind/fragment/en_a0237e1.pf_fragment b/content/_pagefind/fragment/en_a0237e1.pf_fragment
deleted file mode 100644
index a213da0..0000000
Binary files a/content/_pagefind/fragment/en_a0237e1.pf_fragment and /dev/null differ
diff --git a/content/_pagefind/fragment/en_f52d10b.pf_fragment b/content/_pagefind/fragment/en_f52d10b.pf_fragment
new file mode 100644
index 0000000..5798ffd
Binary files /dev/null and b/content/_pagefind/fragment/en_f52d10b.pf_fragment differ
diff --git a/content/_pagefind/index/en_25c7fdb.pf_index b/content/_pagefind/index/en_25c7fdb.pf_index
new file mode 100644
index 0000000..72ce7d3
Binary files /dev/null and b/content/_pagefind/index/en_25c7fdb.pf_index differ
diff --git a/content/_pagefind/index/en_3610413.pf_index b/content/_pagefind/index/en_3610413.pf_index
new file mode 100644
index 0000000..6c97b7a
Binary files /dev/null and b/content/_pagefind/index/en_3610413.pf_index differ
diff --git a/content/_pagefind/index/en_4472174.pf_index b/content/_pagefind/index/en_4472174.pf_index
new file mode 100644
index 0000000..37b47d2
Binary files /dev/null and b/content/_pagefind/index/en_4472174.pf_index differ
diff --git a/content/_pagefind/index/en_4b64e57.pf_index b/content/_pagefind/index/en_4b64e57.pf_index
new file mode 100644
index 0000000..e12ffa1
Binary files /dev/null and b/content/_pagefind/index/en_4b64e57.pf_index differ
diff --git a/content/_pagefind/index/en_56a3c02.pf_index b/content/_pagefind/index/en_56a3c02.pf_index
deleted file mode 100644
index 08d15ea..0000000
Binary files a/content/_pagefind/index/en_56a3c02.pf_index and /dev/null differ
diff --git a/content/_pagefind/index/en_6685b3f.pf_index b/content/_pagefind/index/en_6685b3f.pf_index
deleted file mode 100644
index c287e14..0000000
Binary files a/content/_pagefind/index/en_6685b3f.pf_index and /dev/null differ
diff --git a/content/_pagefind/index/en_67532e3.pf_index b/content/_pagefind/index/en_67532e3.pf_index
deleted file mode 100644
index e9e0b7e..0000000
Binary files a/content/_pagefind/index/en_67532e3.pf_index and /dev/null differ
diff --git a/content/_pagefind/index/en_7d87712.pf_index b/content/_pagefind/index/en_7d87712.pf_index
new file mode 100644
index 0000000..19b7222
Binary files /dev/null and b/content/_pagefind/index/en_7d87712.pf_index differ
diff --git a/content/_pagefind/index/en_b25d232.pf_index b/content/_pagefind/index/en_b25d232.pf_index
deleted file mode 100644
index ff733c6..0000000
Binary files a/content/_pagefind/index/en_b25d232.pf_index and /dev/null differ
diff --git a/content/_pagefind/index/en_b694de7.pf_index b/content/_pagefind/index/en_b694de7.pf_index
deleted file mode 100644
index 60a16c8..0000000
Binary files a/content/_pagefind/index/en_b694de7.pf_index and /dev/null differ
diff --git a/content/_pagefind/index/en_ba923ee.pf_index b/content/_pagefind/index/en_ba923ee.pf_index
deleted file mode 100644
index 23be23a..0000000
Binary files a/content/_pagefind/index/en_ba923ee.pf_index and /dev/null differ
diff --git a/content/_pagefind/index/en_c3e3eec.pf_index b/content/_pagefind/index/en_c3e3eec.pf_index
new file mode 100644
index 0000000..c2eca81
Binary files /dev/null and b/content/_pagefind/index/en_c3e3eec.pf_index differ
diff --git a/content/_pagefind/pagefind-entry.json b/content/_pagefind/pagefind-entry.json
index c7c96ab..7e88bab 100644
--- a/content/_pagefind/pagefind-entry.json
+++ b/content/_pagefind/pagefind-entry.json
@@ -1 +1 @@
-{"version":"0.12.0","languages":{"en":{"hash":"en_5b76dae648","wasm":"en","page_count":134}}}
\ No newline at end of file
+{"version":"0.12.0","languages":{"en":{"hash":"en_bc3217e276","wasm":"en","page_count":134}}}
\ No newline at end of file
diff --git a/content/_pagefind/pagefind.en_5b76dae648.pf_meta b/content/_pagefind/pagefind.en_5b76dae648.pf_meta
deleted file mode 100644
index 727b434..0000000
Binary files a/content/_pagefind/pagefind.en_5b76dae648.pf_meta and /dev/null differ
diff --git a/content/_pagefind/pagefind.en_bc3217e276.pf_meta b/content/_pagefind/pagefind.en_bc3217e276.pf_meta
new file mode 100644
index 0000000..a977e3e
Binary files /dev/null and b/content/_pagefind/pagefind.en_bc3217e276.pf_meta differ
diff --git a/content/contributors/mailing-lists.html b/content/contributors/mailing-lists.html
index 732660d..b171528 100644
--- a/content/contributors/mailing-lists.html
+++ b/content/contributors/mailing-lists.html
@@ -289,37 +289,13 @@ commits list.</p>
# Send dependabot PRs to commits@ instead
pullrequests_bot_dependabot: commits@foo.apache.org
</code></pre><h3 id="configuring-the-subject-lines-of-the-emails-being-sent">Configuring the subject lines of the emails being sent <a class="headerlink" title="Permalink" href="#configuring-the-subject-lines-of-the-emails-being-sent">¶</a></h3>
-<p>The defaults that the tooling uses seems a bit odd to me:</p>
-<pre tabindex="0"><code>github:
- custom_subjects:
- new_pr: "Created: PR {repository}/#{pr_id}: {title}"
- close_pr: "Closed: PR {repository}/#{pr_id}: {title}"
- comment_pr: "Commented: PR {repository}/#{pr_id}: {title}"
- merge_pr: "Merged: PR {repository}/#{pr_id}: {title}"
- new_issue: "Created: Issue {repository} {title}"
- comment_issue: "Commented: Issue {repository} {title}"
- close_issue: "Closed: Issue {repository} {title}"
- catchall: "Updated: {repository}/#{issue_id}: {title}"
- new_discussion: "Created: Discussion {repository}: {title}"
- edit_discussion: "Edited: Discussion {repository}: {title}"
- close_discussion: "Closed: Discussion {repository}: {title}"
- close_discussion_with_comment: "Closed: Discussion with comment {repository}: {title}"
- reopen_discussion: "Reopened: Discussion {repository}: {title}"
- new_comment_discussion: "Commented: Discussion {repository}: {title}"
- edit_comment_discussion: "Edited a comment: Discussion {repository}: {title}"
- delete_comment_discussion: "Deleted a comment: Discussion {repository}: {title}"
-</code></pre><p>However these result in emails that no email client I have come
-across is able to group to threads and I have not come acoss even one
-email where I got to what the email is about on my phone because all I
-could see was: “Commented: Discuss…”.</p>
-<p>We therefore updated these in some projects to a lot shorter versions:</p>
+<p>If not explicitly managing the subject lines, the defaults are as follows (These are the new defaults which are valid starting October 1st 2023):</p>
<pre tabindex="0"><code>github:
custom_subjects:
new_pr: "[PR] {title} ({repository})"
close_pr: "Re: [PR] {title} ({repository})"
comment_pr: "Re: [PR] {title} ({repository})"
merge_pr: "Re: [PR] {title} ({repository})"
- catchall: "Updated: {repository}/#{issue_id}: {title}"
new_issue: "[I] {title} ({repository})"
comment_issue: "Re: [I] {title} ({repository})"
close_issue: "Re: [I] {title} ({repository})"
@@ -332,9 +308,62 @@ could see was: “Commented: Discuss…”.</p>
new_comment_discussion: "Re: [D] {title} ({repository})"
edit_comment_discussion: "Re: [D] {title} ({repository})"
delete_comment_discussion: "Re: [D] {title} ({repository})"
-</code></pre><p>If your project uses multiple github repositories, we recommend using the <code>repository</code> variable to let people know which repo the email is related to.
+</code></pre><p>In general, you can use any of the following variables in your custom subject lines (However some only apply to some types of messages. If this is the case, it is noted in the line what types of messages they apply to):</p>
+<ul>
+<li><code>{action}</code>: The generic action that happened (created/deleted/edited)</li>
+<li><code>{user}</code>: The GitHub user than initiated the action</li>
+<li><code>{title}</code>: The title of the discussion that was affected</li>
+<li><code>{category}</code>: The category slug for the discussion</li>
+<li><code>{url}</code>: The URL for the discussion or comment that was affected (Discussions)</li>
+<li><code>{link}</code>: The URL for the issue or pr that was affected (PRs and Issues)</li>
+<li><code>{body}</code>: The body of text, either the discussion itself or a comment.</li>
+<li><code>{action_human}</code>: If a comment happened, this is a human readable representation of the action</li>
+<li><code>{recipient}</code>: The mailing list this was sent to</li>
+<li><code>{unsub}</code>: The unsubscribe address of the mailing list this was sent to</li>
+<li><code>{pr_id}</code>: The GitHub pull-request id related to the action (PRs)</li>
+<li><code>{issue_id}</code>: The GitHub issue id related to the action (Issues)</li>
+</ul>
+<p>If your project uses multiple github repositories, we recommend using the <code>repository</code> variable to let people know which repo the email is related to.
If your project is a single-repo project (or for the other repositories GitHub integration is not enabled or not used much) feel free to also remove that part.</p>
-<h3 id="conclusion">Conclusion <a class="headerlink" title="Permalink" href="#conclusion">¶</a></h3>
+<pre tabindex="0"><code>github:
+ custom_subjects:
+ new_pr: "[PR] {title}"
+ close_pr: "Re: [PR] {title}"
+ comment_pr: "Re: [PR] {title}"
+ merge_pr: "Re: [PR] {title}"
+ new_issue: "[I] {title}"
+ comment_issue: "Re: [I] {title}"
+ close_issue: "Re: [I] {title}"
+ catchall: "[GH] {title}"
+ new_discussion: "[D] {title}"
+ edit_discussion: "Re: [D] {title}"
+ close_discussion: "Re: [D] {title}"
+ close_discussion_with_comment: "Re: [D] {title}"
+ reopen_discussion: "Re: [D] {title}"
+ new_comment_discussion: "Re: [D] {title}"
+ edit_comment_discussion: "Re: [D] {title}"
+ delete_comment_discussion: "Re: [D] {title}"
+</code></pre><h4 id="using-the-old-defaults-prior-to-october-1st-2023">Using the old defaults (prior to October 1st 2023) <a class="headerlink" title="Permalink" href="#using-the-old-defaults-prior-to-october-1st-2023">¶</a></h4>
+<p>If for any reason, you would like to use the old defaults that were valid till October 1st 2023, please use the following configuration:</p>
+<pre tabindex="0"><code>github:
+ custom_subjects:
+ new_pr: "Created: PR {repository}/#{pr_id}: {title}"
+ close_pr: "Closed: PR {repository}/#{pr_id}: {title}"
+ comment_pr: "Commented: PR {repository}/#{pr_id}: {title}"
+ merge_pr: "Merged: PR {repository}/#{pr_id}: {title}"
+ new_issue: "Created: Issue {repository} {title}"
+ comment_issue: "Commented: Issue {repository} {title}"
+ close_issue: "Closed: Issue {repository} {title}"
+ catchall: "Updated: {repository}/#{issue_id}: {title}"
+ new_discussion: "Created: Discussion {repository}: {title}"
+ edit_discussion: "Edited: Discussion {repository}: {title}"
+ close_discussion: "Closed: Discussion {repository}: {title}"
+ close_discussion_with_comment: "Closed: Discussion with comment {repository}: {title}"
+ reopen_discussion: "Reopened: Discussion {repository}: {title}"
+ new_comment_discussion: "Commented: Discussion {repository}: {title}"
+ edit_comment_discussion: "Edited a comment: Discussion {repository}: {title}"
+ delete_comment_discussion: "Deleted a comment: Discussion {repository}: {title}"
+</code></pre><h3 id="conclusion">Conclusion <a class="headerlink" title="Permalink" href="#conclusion">¶</a></h3>
<p>The custom templates help make the GitHub content readable on your
mailinglist it will therefore not feel as overwhelming as with the
defaults. Moving dependabot to the commits lists, helped reduce the