4 ms·
The CLI is pretty straightforward. First, think of what you want to do, then do it. Consult only the man pages when performing the latter, never some random guy
by juped 6y ago
The CLI is pretty straightforward. First, think of what you want to do, then do it. Consult only the man pages when performing the latter, never some random guy's blog or a confused Stack Overflow post.
Clearing the confused Stack Overflow posts &c. from your mental cache will make it all make sense.
- ahartmetz 6y agoI'm sorry, that is completely useless advice. The manpages randomly bumble around in the abstraction level of their "explanations" and rarely use words that the average person would think of first to describe something.
- kkarakk 6y agosorry i'm gonna sound like i'm making an argument for authority but why do man pages have to appeal to the "average" person anyways? complex tasks require complex explanations to avoid weird hangups/errors. every time i see people complain about the complexity of manpages i always wonder what their work looks like if manpages is the blocking issue to their understanding of a tool
- ahartmetz 6y agoI would agree that most manpages are pretty useful and that they don't necessarily need to be tutorials (it would be against Unix traditions, haha). Git's manpages and CLI are just a particularly bad word soup.
- jl2718 6y agoTODO: man page search engine with semantic term substitution (e.g. Bert). Possibly trained on stackoverfow.
- juped 6y agoI can't really reply to this; it just isn't true, and the text is right there for anyone to read if they want to see for themselves.
- pmeunier 6y agoThis is so "true" that there's even a realistic generator: https://git-man-page-generator.lokaltog.net/ https://git-man-page-generator.lokaltog.net/
- ScottBurson 6y agoHa! Best laugh I've had in a month!