Uncategorized

LaunchDarklyHoloSticker

Stickers, A Love Story

When I was in elementary school, I won a science fair, and travelled to the far-off land of Moscow, Idaho for the state competition. While there, I spent some of my food money on the most magical sticker ever. It was a gleaming metallic unicorn with rainbow colored mane and tail. It brought me joy…

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…

Guest Post on OpenSource.com

Guest Post on OpenSource.com

I was supposed to be at SeaGL this weekend for an awesome conference with the opensource world. Sadly, I fell in the garage and dislocated my shoulder, so I can’t attend. On the bright side, the post I wrote to promote my talk at the conference is available! Four Steps to Better Documentation In it,…

Becoming a welcoming open source project, Mentoring Branch

Becoming a welcoming open source project, Mentoring Branch

Cate Huston (@catehstn) asked what we could do that would get us from “open source” on a project to “welcoming source”.  Codes of conduct, good newbie issues and good onboarding were her initial suggestions, and I said that a good project would also have a really clear goal, because one of my consistent frustrations with…

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 Cardinal Virtues? of Technical Writing

The Cardinal Virtues? of Technical Writing

First, a disclaimer: Medium served me this article, but it’s a year old. Weird. Nonetheless, I have things to say about the content. The Virtues of Technical Writing, by a pseudonymous writer Introduction They are gleaned from a Bachelor of Science degree in Scientific and Technical Communication from the University of Minnesota’s Writing Studies Department,…

Upcoming appearances

DevOpsDays Seattle
DevNet Create
GOTO Chicago
Deliver:AgileAlliance
O'Reilly Software Architecture/Velocity
The Lead Developer London