Comment by pdntspa
While I think man pages are perfectly fine as documentation, the terminal interface for accessing them is awful (more mysterious keypresses or incantations to memorize if you want to do anything more than scroll), and visually I have always found them very difficult to scan visually, particularly if I wasn't sure of the exact wording for the task I needed, or if I am thinking in a different vocabulary. Plus theres the whole wall-of-text thing that makes me kind of instinctively bounce out.
A lot of them also lack sufficient (or any) examples, which are the things I need to see to learn. Making sense of the their sometimes (and seemingly intentionally) obtuse wording when I'm trying to do something I'm not already familiar with makes them a lot harder to parse than they need to be.
And many of the commands are extremely arbitrary. `cd` (change directory) very well could have been `mf` (move folder). `del` in DOS is `rm` in Linux. `move` vs `mv`, `copy` vs `cp`, etc etc. There's no common orthodoxy. If you are not well versed in the history of this stuff its all gobbledygook.
LLMs have been great in this regard, as they can supply those missing examples and then explain to me exactly what it is doing, oftentimes worded more clearly than the original documentation. And they can help me string together whole sequences.
So a TL;DR of your comment is that you just have to learn / memorize to use things. That applies to everything, not just what you are discussing here.
If you only use 'cd', 'mv', 'rm', and 'ln', then really, there is not much to learn. Perhaps the '-rf' option to 'rm', which is how you delete directories (that are not empty). You complained about the naming, but 'mv' requires fewer keystrokes than 'move', and once you know that 'mv' = move, 'rm' = remove, and so on, then what is the issue? It makes sense. DOS had just as "arbitrary" names: 'del' instead of 'rm', for example. The UNIX versions are deliberately short for efficiency, and once you learn them, they are universal.
Man pages are fine. Just press '/' to search by string or regex, and 'n' for next match. They are also consistent: if you want a particular section, you search for it. But it is important to remember that man pages are reference material, not tutorials. If you want quick examples, try https://tldr.sh, https://cheat.sh, or another alternative.
If this is difficult, or you simply do not want to learn it, that is fine: use what works for you. But if you are a programmer, you are going to be learning tools constantly, and the core UNIX utilities are among the simplest. Once learned, they do not change. Personally, I have not had to learn anything new about them since I was 13. I am 31 now. You learn once, and you use forever.
That said, there are real examples of arcane tools. 'ffmpeg' and 'rsync' have some of the most obscure command-line options I have ever seen, which is why I keep bash aliases and functions for the things I do often. That is how you make your life easier as a programmer: learn the fundamentals, then abstract the complexity where it makes sense.
TL;DR: Learning is not optional. Whether it is GNU/POSIX utilities, GUIs, wizards, or even LLMs, you still have to learn them. Man pages are reference material, not tutorials. Learn the basics once, and you are set for life.