Tag: best practices
-
The Art of Booth
I originally wrote this up as an internal blog post, but I think it may be useful for other people, too, so I’ve cleaned it up a bit and taken out most of the proprietary stuff, and added some explanations. I had never in my life done boothwork before this job, so I was surprised…
-
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,…
-
Why on earth would developers WANT to write documentation?
This week I was at DevOpsDays Minneapolis, which was an amazing, warm, and inclusive event. There were at least three open spaces on documentation, communication, and related problems, and I didn’t propose any of them! The question the devops world keeps asking, over and over again is, How do I get developers to write anything?…
-
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: 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…