Documentation

Docs as code doesn’t have to mean Markdown and Git

After almost 15 years as a technical writer for software companies, I’m a convert to the docs as code philosophy. But while I like Markdown and Git (I use them for this website), I wouldn’t use them …

Writing American when it's not your first English dialect

When I started out as a writer I used to use Oxford English. That’s the one with the (correct) -ize spellings. Although as a journalist I was told to avoid unnecessary punctuation and so I avoid …