> In their defense, the Git docs are open source and written mostly by > volunteers (like our lessons). I'm sure they'd appreciate patches clearing up > anything that strikes you as confusing, but balancing clarity, correctness, > completeness, and backwards compatibility can be hard.
I don't think the git docs are inherently any worse than most man pages or other open source documentation. None of these things are easy to understand for somebody who is not of the "concise, accurate and literal" computer science mindset, IMHO. What perhaps makes the git docs worse is that (a) They require familiarity with git concepts that the beginning reader many not have, and that (b) git syntax itself is confusing and inconsistent, as summarised nicely by the Git Koans that somebody linked :-) ----- We invite research leaders and ambitious early career researchers to join us in leading and driving research in key inter-disciplinary themes. Please see www.hw.ac.uk/researchleaders for further information and how to apply. Heriot-Watt University is a Scottish charity registered under charity number SC000278. _______________________________________________ Discuss mailing list [email protected] http://lists.software-carpentry.org/mailman/listinfo/discuss_lists.software-carpentry.org
