4 ms·
Technical writing traditions are mostly evidence-free bullshit that focusses on appearances at the expense of usefulness. I usually find "official" technical d
by TheOtherHobbes 11y ago
Technical writing traditions are mostly evidence-free bullshit that focusses on appearances at the expense of usefulness.
I usually find "official" technical docs very hard to read - much harder to follow and less useful than a typical how-to book.
Writing is not code. Human elements like humour and story-telling make technical content much easier to understand and learn.
And "topic centric" should be something that comes out of testing. User testing should note the most common user taskflows empirically, and write those up in the docs.