Re: git-scm.com
- From
Scott Chacon <schacon@gmail.com>
- Date
- Jul 25, 2008, 21:46 UTC
- Message-ID
- <d411cc4a0807251446k6b7426fbg3ccb2be7de27dc1a@mail.gmail.com>
- In-Reply-To
- <bd6139dc0807251420x32e65e73o8db5d77c8b841947@mail.gmail.com>
I mean to have the new documentation I'm beginning be the 'eye-catcher' on that page eventually. Not because it's done by me, but because it will be open and I want to encourage people to contribute to it (we must make it perfect, after all) :) However, the big thing is that I couldn't think of a _single_ resource that I would want to point people at. I tried to split everything up categorically, but I don't know what you're looking for being there exactly. Thanks for the feedback, though, I'll see what I can do.
As for my own plug, I feel kinda bad about that, but I have gotten a lot of feedback that it's a useful resource and I thought by separating it out into a 'books' section, I had cleanly distinguished between the corporate sellouts and everyone else :) I have Git Magic in the Tutorials section, including a nice plug for it and a link to it's source on Github - if it were an e-book (had a pdf version and a cover) I would happily put it over there. I would like, however, to keep the downloadable resources seperate from the free online resources (though now that I think about it, I should probably put "Git from the Bottom Up" pdf up there somewhere...). I want people to know they have to shell out money for those greedy bastards projects, though. There will be an O'Reilly book soon, and I'll put that up, too. If you have other resources that you think are really good, let me know so I can add them.
Scott
On Fri, Jul 25, 2008 at 2:20 PM, Sverre Rabbelier <alturin@gmail.com> wrote:
Show 29 quoted lines
> On Fri, Jul 25, 2008 at 19:35, Scott Chacon <schacon@gmail.com> wrote: >> A followup on the post I did a few days ago about Git documentation. >> I forked Petr's git.or.cz site and put up a version that I think is a >> bit more accessible and newbie-friendly at git-scm.com. I had meant >> to discuss this with Petr before posting it to you all, but I >> published a blog post that got a bit more attention than I expected, >> and I didn't want you all to think I didn't care about your opinion, >> as some have already accused me of. > > I had a looksie at the site and I think the documentation section [0] > could use some TLC. It might be because it's getting late, but there's > not really any 'eye catchers', no "CLICK ME!" link for someone > browsing around looking for Documentation. In order to find what you > want you have to read -a lot- of the page, which I think is a sign > that the page would do well with some TLC ;). > Now I'll admit that the git.or.cz version [1] is a lot worse, but with > this being an attempt to make it a lot more newbie friendly... > > [0] http://git-scm.com/documentation > [1] http://git.or.cz/gitwiki/GitDocumentation > > PS: I think you forgot the </shameless plug> when you did put up your > own e-book in the books section but did not put "Git Magic" there ;). > > -- > Cheers, > > Sverre Rabbelier >