Skip to content

Best practices

BIG CONCEPTS small docs. User documentation is a failure of user interface. Faster and cheaper than making your developer write it. Elegant writing saves money. Paid by the anti-word.

Why are there no documentation bootcamps or schools?

Sarah Mei and Sarah Fox and some other people and I were talking on Twitter about code school graduates, and how they frequently do really well at mid-level positions because they have communication skills from their previous careers. Yeah, that is super interesting. Thanks for linking it. I guess that's why there's no writing boot…

Creative destruction

Creative destruction

I was making a joke about the fact that I accidentally have two profiles for Open Source Bridge – one is with pink hair, and one with brown hair. Obviously, one of them is the mirror universe me. Probably the one with brown hair. No one with pink hair could be sinister, right? I said…

The art of deleting

The art of deleting

I have a talk where I encourage everyone to be clear on the data they collect and keep. I encourage people to automate deletion so they don’t have to do anything extra. In the original incarnation of the talk, I said that everyone should apply konmari principles to the data they keep, only instead of…

Lady Conference Speaker: Slides

Lady Conference Speaker: Slides

Once you get a conference talk selected, you’ll want to put together the talk. There are speakers who can give entire talks without any visual aids, but most of the rest of us count on having some pictures to look at and prompt us. There are entire books written on slides – I liked Presentation…

Post on Opensource.com: How to nail a tech writer job inteview

Post on Opensource.com: How to nail a tech writer job inteview

I was excited to write another post for opensource.com: How to nail a tech writer job interview It’s an extension of a twitter rant I went on a bit ago, about how important it is to know certain things about interviewing as a technical writer, but no one is teaching them, from what I can…

Screen capture of the front page of a site using folksonomy

Human Indexing

One of the consequences of cheap storage is that we have no incentive to reduce the amount of data we keep. We believe that we’re going to be able to search for whatever we want. But we are starting to exceed our human capacity to filter the returned results of our searches. Algorithms will help…

Documentation Debt

Documentation Debt

People always talk about technical debt, but what about documentation debt? Has anyone ever given a talk on ways to avoid it? — Taylor Barnett (@taylor_atx) February 27, 2017 It was a good question, and a lot of people jumped in to answer it. I’ve given a talk on avoiding product design debt — That’s…

My Philosophy of Technical Writing

My Philosophy of Technical Writing

I said earlier on twitter that I like interviews because it gives me a chance to talk about my philosophy of technical writing and how I’d go about implementing it. Good friends reminded me that the ideal way to talk about one’s philosophy and implementation is while being paid a respectable hourly rate. That is…

Lady Speaker CFP Submissions

Lady Speaker CFP Submissions

The way one becomes a Lady Speaker is by speaking. That’s pretty obvious. But how to do you get someone to give you a stage and a microphone and an audience? That’s what this post will partially cover. Specifically, how do you submit a talk proposal? Find decent conferences There are lots of places you…

Guest post: SysAdvent!

Guest post: SysAdvent!

I wrote a pitch for SysAdvent and got it accepted, and then realized that it was due right in the middle of all my travel, so it’s a good thing my volunteer editor was willing to work with me on the timing. Day 17 – Write It Down or Suffer the Consequences This article has…

Upcoming appearances

Velocity Berlin
Minneapolis DevOps Meetup
DeliveryConf

Scroll To Top