Re: Git documentation at kernel.org
From: Scott Chacon <hidden>
Date: 2016-06-15 22:53:03
Hey, On Sun, Feb 12, 2012 at 2:25 PM, Jeff King [off-list ref] wrote:
quoted
kernel.org is probably the most "official" place for developers, but for Git users, http://git-scm.com/ is most likely the best entry point. If it were not for historical reasons, I think http://git-scm.com/docs/ or so would be the most natural URL to host official docs.Good point. That is probably the best place to host it. As far as historical reasons, perhaps the right answer is to put the documentation where it makes sense to go _now_, and ask kernel.org to issue http redirects for http://kernel.org/pub/software/scm/git/docs.
I would be happy to set this up. I'm currently in the process of revamping the website and this is one of the things I'm planning on doing anyways - not just hosting the generated docs, but also making them searchable and whatnot. Actually, as long as I'm on this, what do people think about git-scm hosting the wiki as well? As far as I can tell, it was down for months and now it's back in some sort of weird read-only state. If I imported everything into a different wiki and hosted it on git-scm would that be acceptable? Also, something that I realized I am not willing to maintain any more is the Git Community Book. It was an experiment at reorganizing some of the docs, but instead I spent my time on Pro Git, which is CC licensed. Would anyone object to me removing the community book from the git-scm site and more tightly integrating the Pro Git content? It's more up to date and better content, I feel - I would rather have one book to maintain than two. However, since it is a commercial product (albeit a Creative Commons licensed one), I wasn't sure if people would have an issue with it. Scott