Uncategorized

Documentation for DevOps: A DevOpsDays Open Space Writeup

Documentation for DevOps: A DevOpsDays Open Space Writeup

I’m borrowing this image from my friends at Chef, because it’s really funny to pretend that it’s possible to just sprinkle on “devops”, something that is about cultural change at every level. At every DevOpsDays I go to (and that’s quite a few), I propose/wrangle/run two open spaces. One is about feature flags/canary launches/hypothesis-driven development,…

Lady Conference Speaker Talk Wrap-Up

Lady Conference Speaker Talk Wrap-Up

I was talking to Bridget Kromhout about her wrap-up process, and she inspired me to a) do a better job publishing my talk information right after I give it, b) talk about my end-of-talk process. So, you have pitched a talk, gotten it accepted, written it, gotten on stage and given it, and answered any…

img_0743

New job title: Developer Advocate

I've had a lot of job titles in my career: Technical Writing Intern Queen of Documentation (It was 2000, OK?) Technical Writer I, II, III Technical Communicator Senior Technical Writer Technical Writing Consultant Documentation Architect Documentation Mercenary You might notice a theme there. I've been a technical writer for a lot of different companies, because…

The Seven Righteous Fights: Security

The Seven Righteous Fights: Security

This is the second fight in my series The Seven Righteous Fights. For an introduction, see The Seven Righteous Fights: Overview. Contrary to what you may have heard, the internet is not actually a series of tubes connected by guys in ski masks. There are bad actors out there, but your product probably won’t attract…

The Seven Righteous Fights: Localization

The Seven Righteous Fights: Localization

This is the first fight in my series The Seven Righteous Fights. For an introduction, see The Seven Righteous Fights: Overview. Are you ever planning on selling this to someone in another country? Or someone who doesn’t speak your company’s primary language? I’ll tell you right now: Yes, you are. There’s a big wide world out there,…

Guest post at Authentic Engine blog

Guest post at Authentic Engine blog

I have a guest post up today at Authentic Engine. Using your “whiskers” to detect disruptions Authentic Engine is a consultancy based on emotionally smart management and fostering workplace inclusivity and team emotional safety.

The Seven Righteous Fights: Overview

The Seven Righteous Fights: Overview

This is a series derived from my popular talk “The Seven Righteous Fights”. It’s not an exact transcript, but I think having a written form to refer people to greatly increases accessibility and gives me room to expand my thoughts in a way that is not compatible with speaking. There are seven fights that I…

How to Teach Your Kids Infosec

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.  …

A chapel constructed entirely of twisted vines and saplings.

What is a documentation architect?

When I was at Write the Docs 2015, several people asked me about the title I have in my LinkedIn heading: Documentation Architect. What did I mean by that? How is it different than content management or development architecture? What a documentation architect isn’t A documentation architect isn’t psychic. They can’t figure out your business…

Upcoming appearances

O'Reilly Software Architecture/Velocity
The Lead Developer London
Full Stack Conference London
Texas Scalability Summit