David Ruttka

I make computers do things

Communication Protip: Be Specific

| Comments

The other day, I says to Michael, I says

We suck so much at communication. Not you and me. I mean, I am including myself, but I mean ‘we’ in the universal human sense.

Today, I sucked again, and I am able to see exactly where I went wrong.

Be Specific

If you have multiple environments being used for development purposes, don’t talk about making updates to “dev.” This is going to confuse people about whether you meant hacky-dev-builds.fancycloud.net or slightly-more-stable-dev.yourdomain.com.

Refer to the environment by something more unique like the URI, and don’t leave room for doubt about exactly what changes you made.

Don’t do this:

I just deployed the latest bits to dev.

Do this instead:

I just deployed to endpoint.host.tld. The changes included in this deployment since the last deployment are X, Y, and Z. [Actions people would need to take because of these changes]?.