]> git.99rst.org Git - git.git/commit
MyFirstContribution: recommend shallow threading of cover letters
authorPatrick Steinhardt <redacted>
Mon, 15 Jun 2026 12:59:41 +0000 (14:59 +0200)
committerJunio C Hamano <redacted>
Mon, 15 Jun 2026 17:13:28 +0000 (10:13 -0700)
commit16b2924aab52141bedd6612dfad16280181321c7
tree5317f7b49a5cd2b684c1b43f6d9404c3dc140637
parent94f057755b7941b321fd11fec1b2e3ca5313a4e0
MyFirstContribution: recommend shallow threading of cover letters

The "MyFirstContribution" document recommends the use of deep threading
of cover letters: every cover letter of subsequent iterations shall be
linked to the cover letter of the preceding version. The result of this
is that eventually, threads with many versions are getting nested so
deep that it becomes hard to follow.

Adapt the recommendation to instead propose shallow threading of cover
letters: instead of linking the cover letter to the previous cover
letter, the user is supposed to always link it to the first cover
letter. This still makes it easy to follow the iterations, but has the
benefit of nesting to a much shallower level.

Signed-off-by: Patrick Steinhardt <redacted>
Signed-off-by: Junio C Hamano <redacted>
Documentation/MyFirstContribution.adoc
git clone https://git.99rst.org/PROJECT