Writing
Created At: - Last Update:- Write Technical Posts
- People care about solutions to problems they have, or expect to have one day.
- “How” without a “why” suggests a contrived solution to a made-up problem. In other words, it’s easily read as “who cares?”
- Headings must provide enough information to let someone know whether or not they care about the following prose.
- This also means that the first sentence of each paragraph should be sufficient to understand the rest of the paragraph. The remaining sentences are only allowed to reinforce or give details of the first sentence. One paragraph equals one idea.
- Don’t underestimate how much credibility you’ll lose from blatantly bad spelling and grammar.
- More important than what you’re saying is what you’re not saying. If you’re giving examples of something that fits a pattern, make sure you give examples of things that do not fit the pattern. A concept that is applicable everywhere is useful nowhere.