I just discovered Semantic Line Breaks. I could never decide on exactly how to do line breaks in markdown so I love that someone came up with a convention that’s been thought through. This led me to discover this post by Derek Sivers: Writing one sentence per line What’s interesting is that while he’s recommending the same approach, he suggests that it will improve your writing itself. Nicer git diffs is just a side benefit. 🙂 ...
Continue with the writing, Today I learned about the inverted pyramid in journalism: It’s a way to structure content so that it “begins with the details that readers care about most. As the article progresses, the focus shifts toward details that are relevant only to the most interested readers.” I came across it in this great post about How to Write Useful Commit Messages but is just as applicable to blog posts/reports/docs/emails. ...
I’ve been working on improving my writing and since it’s an important skill in our industry I figured it’s also a category of learnings worth sharing. I’ve been experimenting with using em dashes (—) lately but I just learned that it’s common to not put spaces around it. Spacing around an em dash varies. Most newspapers insert a space before and after the dash, and many popular magazines do the same, but most books and journals omit spacing, closing whatever comes before and after the em dash right up next to it. ...