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

Re: Git documentation at kernel.org

From
Scott Chacon <schacon@gmail.com>
Date
Feb 12, 2012, 23:04 UTC
Message-ID
<CAP2yMa+2E6101fe3Z2WTCfuGnq17WT7nDUQr7PVH6_YKRnNifw@mail.gmail.com>
In-Reply-To
<20120212222508.GA25619@sigill.intra.peff.net>
Hey,
On Sun, Feb 12, 2012 at 2:25 PM, Jeff King <peff@peff.net> wrote:
Show 10 quoted lines
>> 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
Previous: Jeff KingNext: Jeff King
Message 16 of 21 in “Git documentation at kernel.org”
  1. Petr OnderkaFeb 7, 2012
  2. Clemens BuchacherFeb 8, 2012
  3. Junio C HamanoFeb 10, 2012
  4. Matthieu MoyFeb 10, 2012
  5. Theodore TsoFeb 10, 2012
  6. Konstantin RyabitsevFeb 10, 2012
  7. Ted Ts'oFeb 10, 2012
  8. Junio C HamanoFeb 10, 2012
  9. Ted Ts'oFeb 10, 2012
  10. Junio C HamanoFeb 10, 2012
  11. Jeff KingFeb 10, 2012
  12. Junio C HamanoFeb 10, 2012
  13. Jeff KingFeb 10, 2012
  14. Matthieu MoyFeb 12, 2012
  15. Jeff KingFeb 12, 2012
  16. Scott ChaconFeb 12, 2012
  17. Jeff KingFeb 13, 2012
  18. Junio C HamanoFeb 13, 2012
  19. Jeff KingFeb 14, 2012
  20. Konstantin RyabitsevFeb 13, 2012
  21. Neal KreitzingerFeb 10, 2012

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.