git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2 4/5] MyFirstContribution: reference "The cover letter" in GitGitGadget section

From
Philippe Blain via GitGitGadget <gitgitgadget@gmail.com>
Date
May 11, 2022, 01:47 UTC
Message-ID
<f6034b0964b1e8cccd25f47aa01d51753672df31.1652233654.git.gitgitgadget@gmail.com>
In-Reply-To
<pull.1226.v2.git.1652233654.gitgitgadget@gmail.com>
From: Philippe Blain <levraiphilippeblain@gmail.com>

The "Sending Patches via GitGitGadget" section mentions that the PR title and description will be used as the cover letter, but does not explain what is a cover letter or what should be included in it.

Refer readers to the new "The cover letter" section added in a previous commit.

Signed-off-by: Philippe Blain <levraiphilippeblain@gmail.com>
---
 Documentation/MyFirstContribution.txt | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)
diff --git a/Documentation/MyFirstContribution.txt b/Documentation/MyFirstContribution.txt
index 078b96d674a..728dc437854 100644
--- a/Documentation/MyFirstContribution.txt
+++ b/Documentation/MyFirstContribution.txt
@@ -893,8 +893,12 @@ https://github.com/gitgitgadget/git and open a PR either with the "New pull
 request" button or the convenient "Compare & pull request" button that may
 appear with the name of your newly pushed branch.
 
-Review the PR's title and description, as it's used by GitGitGadget as the cover
-letter for your change. When you're happy, submit your pull request.
+Review the PR's title and description, as they're used by GitGitGadget
+respectively as the subject and body of the cover letter for your change. Refer
+to <<cover-letter,"The cover letter">> above for advice on how to title your
+submission and what content to include in the description.
+
+When you're happy, submit your pull request.
 
 [[run-ci-ggg]]
 === Running CI and Getting Ready to Send
-- 
gitgitgadget
Previous: Philippe Blain via GitGitGadgetNext: Junio C Hamano
Message 30 of 43 in “Improve MyFirstContribution's GitGitGadget section”
  1. 0/3 Improve MyFirstContribution's GitGitGadget sectionPhilippe Blain via GitGitGadget, Apr 27, 2022
  2. 3/3 MyFirstContribution: drop PR description for GGG single-patch contributionsPhilippe Blain via GitGitGadget, Apr 27, 2022
  3. Junio C HamanoApr 27, 2022
  4. Philippe BlainApr 28, 2022
  5. Junio C HamanoApr 28, 2022
  6. 2/3 MyFirstContribution: also explain cover letter in GitGitGadget sectionPhilippe Blain via GitGitGadget, Apr 27, 2022
  7. Victoria DyeApr 27, 2022
  8. Philippe BlainApr 28, 2022
  9. Victoria DyeApr 29, 2022
  10. Philippe BlainMay 10, 2022
  11. 1/3 MyFirstContribution: move cover letter description to a separate filePhilippe Blain via GitGitGadget, Apr 27, 2022
  12. Eric SunshineApr 27, 2022
  13. Philippe BlainApr 27, 2022
  14. Junio C HamanoApr 27, 2022
  15. Philippe BlainApr 28, 2022
  16. 0/5 Improve MyFirstContribution's GitGitGadget sectionPhilippe Blain via GitGitGadget, May 11, 2022
  17. 1/5 MyFirstContribution: add "Anatomy of a Patch Series" sectionPhilippe Blain via GitGitGadget, May 11, 2022
  18. Bagas SanjayaMay 11, 2022
  19. Junio C HamanoMay 11, 2022
  20. Philippe BlainMay 11, 2022
  21. Junio C HamanoMay 11, 2022
  22. Philippe BlainMay 12, 2022
  23. Philip OakleyMay 12, 2022
  24. Philippe BlainMay 12, 2022
  25. 2/5 MyFirstContribution: add standalone section on cover letterPhilippe Blain via GitGitGadget, May 11, 2022
  26. Junio C HamanoMay 11, 2022
  27. Philippe BlainMay 11, 2022
  28. 3/5 MyFirstContribution: reference "The cover letter" in "Preparing Email"Philippe Blain via GitGitGadget, May 11, 2022
  29. 5/5 MyFirstContribution: drop PR description for GGG single-patch contributionsPhilippe Blain via GitGitGadget, May 11, 2022
  30. 4/5 MyFirstContribution: reference "The cover letter" in GitGitGadget sectionPhilippe Blain via GitGitGadget, May 11, 2022
  31. Junio C HamanoMay 11, 2022
  32. Victoria DyeMay 11, 2022
  33. 0/5 Improve MyFirstContribution's GitGitGadget sectionPhilippe Blain via GitGitGadget, May 12, 2022
  34. 3/5 MyFirstContribution: reference "The cover letter" in "Preparing Email"Philippe Blain via GitGitGadget, May 12, 2022
  35. 1/5 MyFirstContribution: add "Anatomy of a Patch Series" sectionPhilippe Blain via GitGitGadget, May 12, 2022
  36. 5/5 MyFirstContribution: drop PR description for GGG single-patch contributionsPhilippe Blain via GitGitGadget, May 12, 2022
  37. 4/5 MyFirstContribution: reference "The cover letter" in GitGitGadget sectionPhilippe Blain via GitGitGadget, May 12, 2022
  38. 2/5 MyFirstContribution: add standalone section on cover letterPhilippe Blain via GitGitGadget, May 12, 2022
  39. Junio C HamanoMay 19, 2022
  40. Philippe BlainMay 21, 2022
  41. Junio C HamanoMay 22, 2022
  42. Philippe BlainMay 24, 2022
  43. Junio C HamanoMay 24, 2022

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.