3 ms·
Wording is one thing, but what is always annoying moving to a new library or language is the tacit knowledge the docs assume. It's a fine line, one can assumes
by wouldbecouldbe 4y ago
Wording is one thing, but what is always annoying moving to a new library or language is the tacit knowledge the docs assume.
It's a fine line, one can assumes a certain knowledge to even be functional, but in doubt I think it's better to be extra verbose.
Few examples:
- JS libraries not showing how to import the modules used in code examples.
- Everything in the kubernetes docs
- In Xcode explanations often it just mentioned: go the "build settings", etc. In beginning it's extremely confusing to find anything in that program.