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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]