Re: Migrate away from vger to GitHub or (on-premise) GitLab?
- From
- Dragan Simic <dsimic@manjaro.org>
- Date
- Feb 2, 2024, 11:13 UTC
- Message-ID
- <8f5ca8f5dfd465fea0a53dabc81a58cd@manjaro.org>
- In-Reply-To
- <6b34d999-3da2-42ef-bfff-37c8f592347f@gmail.com>
On 2024-02-02 12:07, Phillip Wood wrote:
Show 14 quoted lines
> On 01/02/2024 19:00, Dragan Simic wrote: >> On 2024-02-01 19:36, Hans Meiser wrote: >> Please keep in mind that editing the git man pages requires very >> intimate knowledge of the related git source code. Many times even >> small changes to the language style can change the meaning and diverge >> the man pages from the source code, making the man pages useless. > > While there are some aspects of the documentation that require a > familiarity with the source I don't think that is true in general. If > someone has a suggestion to improve part of the documentation that > they found hard to understand we should be encouraging them to > contribute a patch. There is no doubt that there are places where our > documentation could be improved and it is not necessary to be a C > programmer to contribute improvements to it.
Sure, but there has to be someone with intimate knowledge of the git source code in the entire chain, if you agree, to make sure that improving the readability or style doesn't diverge the man pages from the truth.