Author: Ben Cotton

Ben formerly led open source messaging at Docker and was the Fedora Program Manager. He is the author of Program Management for Open Source Projects. Ben is an Open Organization Ambassador and frequent conference speaker. His personal website is Funnel Fiasco.

Embrace the non-judgmental “why?”

People don’t make bad decisions on purpose. If you understand why a decision was made in the past, you make better decisions for the future.

Posts

Footnotes and asides are a warning

Overuse of footnotes, commas, em dashes, and parentheses suggest your writing may be unclear. Keeping sentences focused helps your reader.

Posts

Use a decision log to record context

A decision log is a record that you leave for the future. It shares the context to save time when revisiting a past decision.

Posts

Words mean things

Choose your words carefully. You want people to discuss the facts, not the wording.

Posts

A donation for every sale in March

I’ll donate $10 for every ebook sale of my book on 8 March to Girls Who Code. For the rest of March, I’ll give $5 for every paper or ebook sale.

News

Be clear about who does what

If you’re not clear about who is supposed to act, people will assume that it’s not them. Be clear so everyone knows what to expect.

Resources

What you’re measuring is different from how you measure it

Start with understanding the “why?” behind what you’re trying to measure. Then figure out the measurements, knowing they’ll be imperfect.

Posts

It’s better to be clear than correct

Your prose is not code; it will not fail because you forgot a semicolon. Prefer being understood to strict adherence to grammatical rules.

Resources

Write standard operating procedures

When you document how to execute a process, that ensures you’ll do it right the next time. This helps your future self and your successors.

Posts

AIANYF: Acronyms & Initialisms Are Not Your Friends

Acronyms can be confusing when they’re unfamiliar to your reader. Err on the side of explaining, even if you don’t think you need to.

Resources