> 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. Sure. Eventually, I'd rather propose to have parts of the man pages be generated from code comments (XmlDoc, JsDoc or similar), particularly syntax and parameter list. That would keep documentation from deviating from code right from the beginning. And it would keep documentation writers from manually updating obvious parts. > A git server? I was under impression that you proposed running an > own instance of GitLab or something similar. Basically, GitLab, GitHub, Azure DevOps are all just Git servers, plus collaboration and automation functionality. I suggested using GitWeb only in case you wanted to write (and keep control over) collaboration and automation functionality yourself. Otherwise you may use one of the existing ones that have already been written (i.e., GitLab, GitHub, Azure DevOps).
