De facto Best Practices

Here’s a collection of articles I found myself referring back to over and over again. They became over time de facto standards, cheat sheets and best practices for software development to me.

Biases

• 50 Cognitive Biases in the Modern World by Marcus Lu
• Chesterton’s Fence: A Lesson in Second Order Thinking
• Why incompetent people think they’re amazing by David Dunning

Career

• A Hippocratic Oath for Technologists by Mariesa Dale
• Charte d’Ethique de l’Ingénieur par l’IESF
• progression.fyi
• SMART Goals by Indeed Editorial Team

CLI

• Moving efficiently in the CLI by Clément Chastagnol

Coding

• Five Factor Testing by Sarah Mei
• Test Doubles by me
• Workflows of Refactoring by Martin Fowler

Continuous Integration & Delivery

• 6 Best Practices for Continuous Delivery Pipelines by Derik Evangelista & myself

Documentation

• Architectural Decision Records
• README Maturity Model by Lauri Apple
• The Inclusive Naming Initiative
• The documentation system by Danielle Procida

Logging

• Logging v. instrumentation by Peter Bourgon
• What’s in a Good Error Message? by Gunnar Morling
• When life gives you lemons, write better error messages by Jenni Nadler

Meetings

• Platform as a Service team takes even-handed approach to meetings by Dan Carley
• The Silent Meeting Manifesto v1: Making meeting suck a little less by David Gasca

Open Source

• The 5 Types of Open Source Projects by Josh Berkus

Process

• Continuous Delivery checklist template

Scaffolding

• Filesystem Structure of a Go project by Flavio Copes

Source-Control

• Clean .gitignore files by Markus Tacker
• Conventional Commits

Support

• PagerDuty Incident Response

Time Management

• Maker’s Schedule, Manager’s Schedule by Paul Graham
• Pomodoro Technique by Francesco Cirillo