On 5/4/2012 6:29 PM, Scott Chacon wrote:
I just shipped a big update to the git-scm.com website...
Thanks for the cool website, old and new! :)
* There is now permanent man page hosting here, for example:
http://git-scm.com/docs/git-fsck. You can also reference any older
version of any command: http://git-scm.com/docs/git-fsck/1.5.5
IMO, I think the reference manual before the kernel.org crash was the
best. Back then, you first got a list of all the versions and you
picked your version. If I'm on version x I want to click on version x
one time for the entire refman, not for every manpage.
I prefer the git.git make doc version of the html. If you could have a
'classic' view of the reference manual that would be great. I'm not an
expert on the make doc technologies, but if your version is harder to
get working then a classic view would enable you to quickly and reliably
publish updates while ironing out the enhanced version.
Also, the new format has *way* too much whitespace on the sides for the
manpages. (Progit also has too much whitespace -- was it like that
before?) The manpages are long enough without double column width in a
single column. ;) The related topics is interesting. I think this
hybrid reference manual format should be called 'enhanced' or something.
I think its important to keep the official git reference manual
clearly distinguished from supplemental material because some of the
supplements are not correct (ie, [a]progit merge=ours). I think the new
hybrid format disguised as the reference manual will cause the newsgroup
to get alot of questions about supplemental material confused with the
reference manual pages. They probably already spend too much time
correcting my bum scoop posts as it is. ;)
I'm not a website expert, but an option to pick a stylesheet that has a
main theme color of blue, green, etc., as opposed to red-orange that
would a big plus in keeping with the open source concept. I'm not a
visual brain scientist, but I think my aversion to staring at a
red-orange website all the time has something to do with why walls are
not normally painted red-orange either. ;)
* There are still a few asciidoc parsing issues that we're working on
- if you find anything that's weird please report it at our issue
tracker: https://github.com/github/gitscm-next/issues
git-rebase manpage is pretty hosed. (when i tried to report on github
it wanted me to signup.)
Footnotes:
a. http://git-scm.com/book/en/Customizing-Git-Git-Attributes,
http://comments.gmane.org/gmane.comp.version-control.git/192798
v/r,
neal
--
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