On this site you’ll find my blog, links to things I’ve done in other places, and my contact details. I’m always happy to hear from others in the industry and you are welcome to reach out to me with requests for articles, podcasts, or speaking – I can’t do everything, but that doesn’t stop me trying!
Welcome! I’m Lorna: open source technology leader and developer experience engineer. I’m a striking combination of technical experience, communication skills, and a genuine love for enabling others to succeed. I’m a leader, an engineer, a writer, a user champion, an open source maintainer, and a public speaker. My passion is taking great technology, and making it a great experience for users.
From The Blog
23 Aug
2023
Selective prose linting with Vale’s glob switch
Vale is an open source CLI tool for linting prose (if you’re not linting prose yet, why not? I never want to go back). I typically use it for everything, locally and in CI, and it’s especially valuable now I’m working for a company that uses US English. You’d think that most of the challenges would be caused by the majority of non-native English language contributors? Nope, most of the chaos comes from the token Brit :)
I ran into one challenge though where I didn’t want to enable Vale for everything: a large internal documentation repo. This is the catch-all of things we should share with one another and like most internal company documentation sites, there is a lot going on. I assembled a very minimal set of Vale rules and still the first pass netted me over 10k errors. Luckily, Vale has a --glob
option, but it took me a while to find how to exclude multiple files and directories using it, so here’s the example for future-me, and anyone else who needs to see it! Continue reading
20 Jun
2023
Visualise OpenAPI with Blockly
Giving talks about OpenAPI often means lots and lots of slides of YAML. In fact, one of my talks even contains a “warning, contains yaml” slide! If you aren’t a professional yaml developer, it can be difficult to digest and learn from, and so I wanted to do better. The various elements are nested inside one another, and so I had this idea to build a representation of OpenAPI using Blockly (the tooling also used for Scratch, if you’ve seen that).
12 Jun
2023
Tips for better documentation with OpenAPI
I love documentation, which is supposed to be rare for software engineers. I am pretty sure that loving documentation is actually very common, but not very cool and so few people admit to it! I love reading good docs, and so I love writing them too. Between hanging out in the Write the Docs community, and recently being at the APItheDocs conference, I’ve answered a bunch of questions about getting good documentation from an OpenAPI document, so I thought I’d round them up in case it’s useful. Continue reading