Blog

1. How to avoid being doxxed: protecting your personal information online 03 Nov 2021

   How to protect your personal information online, and a few related internet survival tips.

2. Write the Docs Prague 2021 05 Oct 2021 conference write the docs

   Notes from Write the Docs Prague 2021.

3. API Specifications Conference 2021 30 Sep 2021 API OpenAPI conference

   Quick notes from my first time at the API Specifications Conference.

4. Buildkite notes 17 Aug 2021 continuous integration

   A collection of notes and commands for Buildkite. Mostly so that I don't have to keep googling how to start things.

5. Designing your own personal planning system 01 Jul 2021 personal planning

   How (and why) to create a personal planning system that works for you.

6. Resources for freelancers working as sole traders 25 Jun 2021 freelance

   A quick collection of resources and things to consider when registering as a sole trader in the UK.

7. Empathy in documentation 06 Jun 2021 technical writing empathy

   How empathy helps us write better documentation.

8. Create multiple websites from one Obsidian vault 01 Jun 2021 obsidian netlify git jamstack

   Use Github and Netlify to create multiple websites from one Obsidian vault.

9. Deploying MkDocs with Material Insiders theme to Netlify 24 May 2021 technical writing jamstack netlify

   A relatively simple (but not entirely clean) way to deploy MkDocs with Material Insiders theme to Netlify.

10. How to activate venv in Git Bash on Windows 12 Apr 2021 windows python git bash

    When running `venv/Scripts/activate` doesn't appear to work.

11. Mission, vision, and values - for a solo freelancer? 20 Oct 2020 careers freelance professional development

    Reflections on a ZingTrain webinar on creating a mission, vision, and values for your company.

12. Hacktoberfest 2020 14 Sep 2020 hacktoberfest hackathon open source write the docs

    A virtual hackathon for Hacktoberfest 2020.

13. Become a tech writer: a quickstart guide 01 Aug 2020 technical writing careers professional development

    In the spirit of a code quickstart, this is a quick, opinionated, description of one possible tech writing learning path.

14. Setting up the Huawei Honor Band 5 03 May 2020 huawei mobile wearables

    The steps for setting up the Huawei Honor Band 5 are not simple if you don't have a Huawei phone. This short article provides workarounds for a few issues, including Huawei Health and Huawei Mobile Services not running, and the missing oximeter.

15. Deploy a MadCap Flare webhelp to Netlify 03 Apr 2020 netlify madcap flare

    Sharing a sample project and quickstart for how to deploy a MadCap Flare webhelp output to Netlify's hosting.

16. Deploying MkDocs with Material theme to Netlify 15 Feb 2020 technical writing jamstack netlify

    Key points when deploying MkDocs projects to Netlify.

17. Getting the most out of online communities 20 Jan 2020 networking freelance

    Some tips for networking, learning and living in online professional communities.

18. Starting a new TDD Laravel project 24 Nov 2019 Laravel Test driven development TDD

    My personal Laravel quickstart, for a Laravel project with test driven development.

19. Decisions in a short doc 10 Nov 2019 technical writing

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

20. Edit a file on GitHub 01 Oct 2019 github open source

    How to make small edits directly on GitHub.

21. How to 'exit' git branch 25 Sep 2019 git

    Using git branch can bring up a long list of branches. This is how to 'exit' the list.

22. Hacktoberfest 2019 05 Sep 2019 hacktoberfest hackathon open source write the docs

    A virtual hackathon for Hacktoberfest 2019.

23. AWS CLI errors on Windows 10 07 Aug 2019 aws aws cli windows

    Two issues when getting up and running with AWS CLI on Windows 10: no module named awscli.clidriver and unknown encoding: idna.

24. When Curl isn't Curl 07 Jul 2019 curl powershell windows Invoke-WebRequest

    Curl in PowerShell and Curl elsewhere are not the same thing.

25. Vilnius 2019 notes: Legacy docs 06 Jul 2019 conference write the docs legacy docs

    Notes from the legacy docs conference talk at Write the Docs Vilnius 2019

26. Vilnius 2019 notes: Internal docs 05 Jul 2019 conference write the docs dev docs internal docs

    Notes from the dev docs conference talk at Write the Docs Vilnius 2019

27. Vilnius 2019 notes: Documenting a new field 04 Jul 2019 conference write the docs greenfield new field

    Notes from the documenting a new ecosystem talk at Write the Docs Vilnius 2019

28. Vilnius 2019 notes: Microcopy 03 Jul 2019 conference write the docs microcopy

    Notes from the microcopy conference talk at Write the Docs Vilnius 2019

29. Why the short blog posts? 02 Jul 2019 blogging

    My blogging inspiration and purpose.

30. Option selection bug in CLIs on Windows 26 Jun 2019 Node JS Windows 10 Windows CMD Powershell Windows

    When you can't use your arrow keys to select options in CMD or Powershell.

31. Find and remove AWS services 08 Jun 2019 AWS

    Check what AWS services you are using, and remove them.

32. Create a Hugo shortcode 29 Sep 2018 Hugo tutorial static site generator

    Learn about Hugo shortcodes, and build a simple example.

33. Quick cookie consent 22 Sep 2017 GDPR cookies analytics

    Add basic cookie consent to your website