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

Re: Anybody know a website with up-to-date git documentation?

From
Max Horn <max@quendi.de>
Date
Jan 30, 2013, 17:05 UTC
Message-ID
<6BE76AE4-254E-43DD-A3FF-88B5486029A5@quendi.de>
In-Reply-To
<CAMK1S_i+ML+HuTRuox5rU4bsV0+xoFLWpK63WrdXuzhgyHJbrA@mail.gmail.com>
On 30.01.2013, at 16:59, Sitaram Chamarty wrote:
> I'm curious... what's wrong with 'git checkout html' from the git repo
> and just browsing them using a web browser?
Hm, do you mean "make html", perhaps? At least I couldn't figure out what "git checkout html" should do, but out of curiosity gave it a try and got an error...
But supposing that you meant "make html": There is nothing "wrong" with it. This is mostly a matter of convenience:
* Many people just use git and don't have the git.git repos (or any git sources) at hand.  And while for many things, older versions of the reference pages may suffice, this is not always the case.
* When I want to point somebody at something specific in the git docs while, say, while discussing on IRC or a mailing list, it is very convenient to point them at a website, like this:
   http://git-htmldocs.googlecode.com/git/git-fast-import.html#_code_notemodify_code 
* Similarly if I am standing physically next to somebody sitting at their computer and they ask me something about git, it is nice to be able to send them to a current version of the docs online
* I can access the web version from my tablet -- and I actually do that (use my tablet as "secondary screen" showing some git refs and other docs while coding on my laptop).
* a website can be update by one person (or ideally: one script) and serve many people with the same need Seems more efficient than each of those people setting up an appropriate clone & a cron job to keep it up-to-date on each machine where they need it.
But of course, the "make html" has its own clear advantages, e.g. I can use it online, I have full control over which exact version of the docs I get, including most recent changes, etc. To me, the two complement each other.
Anyway, I'll stop spamming the list, I got my answers from John and Junio:
  http://git-htmldocs.googlecode.com/git/git.html
and in addition 
  http://manned.org/git.1

Thanks again, Max

Previous: Sitaram ChamartyNext: Junio C Hamano
Message 8 of 12 in “Anybody know a website with up-to-date git documentation?”
  1. Max HornJan 30, 2013
  2. John KeepingJan 30, 2013
  3. Sebastian StaudtJan 30, 2013
  4. Max HornJan 30, 2013
  5. Sebastian StaudtJan 30, 2013
  6. Max HornJan 30, 2013
  7. Sitaram ChamartyJan 30, 2013
  8. Max HornJan 30, 2013
  9. Junio C HamanoJan 30, 2013
  10. Sitaram ChamartyJan 30, 2013
  11. Drew NorthupFeb 17, 2013
  12. Junio C HamanoJan 30, 2013

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.