On Fri, Jul 25, 2008 at 6:53 PM, Petr Baudis  wrote:

quoted text
>  Hi,

>

> On Fri, Jul 25, 2008 at 10:35:43AM -0700, Scott Chacon wrote:

>> Anyhow, I'm discussing with Petr about where we want to go from here -

>> what changes he'd like to make, etc, but I obviously value your

>> opinion as well, so please let me know what you think.  The content

>> has barely changed, it's really just a usability overhaul.  I want to

>> make sure that whatever someone is looking for (especially someone

>> new), they can find in a few clicks and a few seconds.

>

>  when the initial NIH reaction passes, I have to admit that I do rather

> like it - and it's not only because you keep mentioning how awesome I am

> in your blog post. ;-)

>

>  I wonder if all the Git users find the heading rather funny as I did,

> instead of unprofessional - but maybe we don't care about users without

> a particular sense of humor. I'm also not overly fond of the color theme

> but I'm perhaps just too heavy of a blue fan.

>

>  Plenty of minor fixes are available for pull at

>

>        git://github.com/pasky/learn-github.git

>        (http://github.com/pasky/learn-github/tree/master)

I've pulled in all this stuff and it should be live now.
>

quoted text
>  Other non-trivial nits:

>

>  * I'm feeling a bit uneasy about listing so many projects using Git;

> I haven't heard about quite a few of these and I'm not sure on what

> merit should we list projects. "Prototype" or "Liftweb" and probably

> even "Rubinius", is that going to ring a bell for major part of visitors

> so that they say "oh, even _those_ guys are using Git"?

Based on a conversation in the other thread, I think we should have a

list that is suggested by the community and just have the 3 or 4 that

are really famous (Git, Linux, RoR...) and have the rest randomly

pulled from that list - changed every day or so.
>  * Cut the contributors list at 4 or 5 commits? Below that, the list

quoted text
> is getting fairly useless anyway and you have trouble with keeping the

> names reasonably well-formed.

Done and pushed.
>  * Reusing captions from command manpages in the Documentation page

quoted text
> shows nicely how awful they sometimes are. :-) This is probably something

> to fix upstream, though.

I saw you changed some of these, I can take another pass.  I'm not

entirely sure how useful it is to have the commands on that page, to

tell the truth.  This may go away as the documentation page evolves.
>  * Is "Git for the lazy" really unique in some regard to deserve to be

quoted text
> listed among the other resources? I think we should minimalize

> redundancy at the documentation page, the amount of material is already

> overwhelming and it should be obvious for the visitor which document to

> choose based on his needs. I have similar doubts about the 37signals

> resources.

>

>        In other words, "let's keep the resources orthogonal!"

I agree - I would like to pull a lot of the information in those links

into one open-source book that is kept up by the community and hosted

at this page.  The documentation page will change significantly as we

try to simplify and maximize the usefulness of the page.
>  * There is no reference to the Wiki in the documentation, only to the

quoted text
> [GitDocumentation] page; I think there should be a reference to the

> [GitFaq] page too - a lot of important points that are not obvious

> to newcomers are covered there. I'm just not sure where exactly to put

> the link.

>

>  * I would go as far as put the link to the Wiki itself to the

> navigation bar, simply since it is such a crucial resource.

Perhaps I should just do this - would that cover the previous one as well?
>  * A guide on maintaining third-party patches is currently missing.

quoted text
>

>  * The development page is not referenced anywhere; the missing

> information are mailing list details (how to subscribe) and a link to

> SubmittingPatches. Also, I have recently talked with Junio about adding

> a link to the Note from the Maintainer, but we didn't yet figure out

> where to stabilize the location of that page.

I would be happy to put the note somewhere, and I will work on getting

the other few pages from the original site put up and linked

somewhere.
>  How does that compare with the Git user manual? Have you considered

quoted text
> collaborating on that one, or what are your reasons not to? Or are you

> trying to do something different?

I would like to - I have personally found that invaluable in learning

Git, but I would like it to be more digestible and I would like to add

a lot of supporting media to it - screencasts and diagrams, to help

people that are more visual learners. Loading up a document where the

TOC is several pages long is intimidating and difficult to start and

stop with.
Scott

--

To unsubscribe from this list: send the line "unsubscribe git" in

the body of a message to majordomo@vger.kernel.org

More majordomo info at  http://vger.kernel.org/majordomo-info.html