# Sandy Maguire - How to Write Technical Posts (Highlights)  ## Highlights - You’ll make it easier for people to understand what you’re trying to tell them The value of this post - four sentences to convince them - solutions to problems - focusing on *why* - first sentence of each paragraph should be sufficient to understand the rest of the paragraph - keep them on the same page Less distractions - Point out what they might be thinking, and then very explicitly show them what they should be thinking instead. - If you’re giving examples of something that fits a pattern, make sure you give examples of things that *do not* fit the pattern. - People learn by seeing lots of examples - Anticipate which parts of your argument will be difficult for your readers Empathy