Skip to content

Blog

The blog contains . . . everything. Quick references, miscellaneous tutorials, conference notes, and so on. It's a blog as brain with a tech focus. For many of the posts, I am the primary intended audience: the blog is there so I can quickly look up things I need. Others are more tutorial-like, or designed to answer quick questions. The writing style is generally informal, and closer to natural language than I'd use in documentation. I don't reliably maintain and update the content in this section.

  • Decisions in a short doc


    An insight into the number of decisions a tech writer makes, even in a short document.
    Read more

  • The first tech docs project


    A trip down memory lane, mulling on inspiration and impact.
    Read more

Posts

Docs like code in very basic terms

Most guides to docs like code, even the ones for non-devs, assume you have some developer knowledge: maybe you're already using version control, or you've encountered build pipelines before, or you're working alongside developers.

This guide is for the people who read that paragraph and wished it came with a glossary. This is docs like code for people who don't know what git is and have never installed VS Code.