I am getting ready to launch a tech/personal opinion blog slightly more geared towards technical details. What documentation style is best for a journalistic/technical doc style? Thanks.
migrated from english.stackexchange.com Jan 8 at 17:45
This question came from our site for linguists, etymologists, and serious English language enthusiasts.
I always use a simple rule: your style should reflect your intentions. If I was writing a novel, and wanted to describe a room in exquisite detail, I would use a lot more adjectives than if I were writing some code documentation.
Basically, I'd say follow Strunk & White's The Elements of Style and keep your language as straightforward as possible. Since this is a technical blog especially, active voice and "making every word tell" will go a long way.