Best practices

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…

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: Now What?

The Seven Righteous Fights: Now What?

This is the conclusion to my series The Seven Righteous Fights. For an introduction, see The Seven Righteous Fights: Overview. Hopefully I have convinced you that these fights are worth having, worth putting some of your capital and effort into. But now how do you do that? You can’t fight alone and win. You’ll burn yourself…

The Seven Righteous Fights: Accessibility

The Seven Righteous Fights: Accessibility

This is the seventh fight in my series The Seven Righteous Fights. For an introduction, see The Seven Righteous Fights: Overview. We all use computers different ways. Does your software allow that? Here are some ways you can add accessibility with relatively little effort. Take your glasses off. Can you see any of the interaction…

The Seven Righteous Fights: Acceptance

The Seven Righteous Fights: Acceptance

This is the sixth fight in my series The Seven Righteous Fights. For an introduction, see The Seven Righteous Fights: Overview. Have you shown this product to any actual humans who are like the users? Acceptance is the act of testing your vision against the user’s needs. It’s not about whether the software works, or…

The Seven Righteous Fights: Affordance

The Seven Righteous Fights: Affordance

This is the fifth fight in my series The Seven Righteous Fights. For an introduction, see The Seven Righteous Fights: Overview. Affordance is what the interface makes easy and obvious. Affordances tell us all sorts of things about the tiny interactions we have with the world, and with software. Most people talk about the affordances…

The Seven Righteous Fights: Extensibility

The Seven Righteous Fights: Extensibility

This is the third fight in my series The Seven Righteous Fights. For an introduction, see The Seven Righteous Fights: Overview. What can you do that would make your product more extensible, more configurable, easier to put into the ecosystem you are trying to serve? I always explain APIs as a sort of Lego connector…

Upcoming appearances

Velocity Berlin
Minneapolis DevOps Meetup
DeliveryConf