I’ve been switching from Vim to Helix recently. I did the built-in tutor, and whenever I need to configure something, I look it up in the docs. The problem is, I only find what I already know to look for. Without reading the documentation more broadly, I don’t really know what I can configure in the first place.
So I’m curious, do you sit down and read documentation to understand a tool, or do you just search it when you hit a specific problem?
Depends on the docs but if they’re written well you’re best served by reading them in full. Rftm before looking at best practices and tips.
Problem is a lot of people don’t understand how to read a doc. There’s a terminology, phraseology, syntax. I have so many instances of people who say they didn’t see the answer in the docs and then you look and it’s right there. But the human mind tends to discard info it doesn’t understand how to process.
If you think you know how the Internet works but haven’t read the RFCs you might not know as much as you think you do. Read pretty much every one on ipv6 because the second hand resources are absolutely garbage.
This reminds me of the ExifTool documentation… It feels like a well written documentation (and probably is) but the lack of context as a non programer can be overwhelming ://.
Thankfully, the forum was of great help and the maintainer is still active after all these years… Incredible tool by the way !!!