3 ms·
Technical writer checking in to cosign everything you've said here. Most style guides advise against this kind of language for the exact reasons you outline—it
by spondylosaurus 4y ago
Technical writer checking in to cosign everything you've said here. Most style guides advise against this kind of language for the exact reasons you outline—it adds nothing to documentation and it's pithy marketing-speak.
Don't hype up how easy it is to install your product... just tell us how to install the damn thing! :P
> HOWEVER. Writing is its own craft, and requires a totally separate set of skills than your typical engineer-turned-technical-writer is generally equipped with.
Also, completely on point, although in my experience product managers are far worse offenders than engineers.