Posts

Contract additions

Last year, I signed 4 contracts for work-for-hire. I estimate that will be average-to-low going forward, but I don’t have enough data points. Every time I work with a company, I come up with something I want to remember to specify for the next time, or at least attempt to negotiate for. Summary: Work-for-hire does…

The three documents you ACTUALLY need first

Because I work as only-writer for so much of my time, I forget that I’m not just a lone technical writer, and I’m not just an indie, but I’m in an odd category beyond that. Because no one who hires me really knows what a technical writer does, interviewing is often turned on its head…

Search-First Writing for Non-Writers (Open Source Bridge, 2013)

If people can’t use your software, you have already failed as a developer. This talk digs in to how optimizing for search and using the existing technical assistance forums can put your product ahead of the pack. Technical writing, in all its variations, is a type of interface with your product. It incorporates everything from…

Search-First Documentation: Tags and Keywords for Frustrated Users (Write the Docs, 2013)

If people can’t use your software, you have already failed as a developer. This talk digs in to how optimizing for search and using the existing technical assistance forums can put your product ahead of the pack. Technical writing, in all its variations, is a type of interface with your product. It incorporates everything from…

Success Is More Than Not-Failing (Write the Docs, 2015)

We talk a lot about minimum viable products, and building our products up from small features. We talk a lot about failure, and how to learn from it and not replicate failures over and over again. But what I haven’t heard a lot of discussion about is how we know we’ve succeeded. Is it market…

Cassandra at the Keyboard: Whistleblowing at All Scales (Open Source Bridge, 2015)

Cassandra was a prophetess doomed to be accurate, but never believed. In my role as a technical writer, I often have the information needed to make useful observations about development processes, communication problems, and other organizational troubles. The problem is getting people in power to agree with and act on the information I present. This…

Digital Sandwich Generation: Women’s Roles In Identity Management For Others (Alterconf Chicago, 2015)

I don’t know of any parenting books that tell you how to choose baby’s first handle. I don’t know of any self-help books that tell you how to help your parents create a digital estate plan. Both of these scenarios and many more are falling to the people who have always been responsible for maintaining…

How to Teach Your Kids Infosec

I have an article published at Recompiler Magazine! How to Teach Your Kids about InfoSec It’s a summary of best practices for keeping your kids actually safe, instead of sheltered, as they venture online. For a counterpoint, you can come to Alterconf Minneapolis to hear my kid speak on a similar topic on April 9.  …

The Death of Data (Surge 2016)

Search-First Writing for Developers (Pycon AU, 2016)

Upcoming appearances

Velocity Berlin
Minneapolis DevOps Meetup
DeliveryConf