Git is Shit
pileofpoo.wordpress.com
pileofpoo.wordpress.com
1. Normalize the documentation's terminology. There are several places with conflicting names for the same thing. (E.g. "index" vs "staging area") It needs to be consistent.
1a. Even better, come up with some more intuitive names for stuff. Seriously, the word "index" gives zero intuitive understanding of what it does.
2. Make a dedicated glossary of all terms and link to it religiously. Many of the extremely important definitions are buried in random, seemingly unrelated pages.
2a. Even better, order the glossary so you can read top-to-bottom without skipping down and get a summary of the important terms and their relation to each other.
These documentation changes would help immensely.
...where's the downvote button. :-/
Git better, I guess?