#clarity

A guide to writing technical documentation that is clear, informative, and fun!

The secret of good programming is to strip every statement to its cleanest components.

If you don’t know what message to write, it was too long since you last committed.

Don’t use AI to write text for you, or you’ll lose the opportunity to sharpen your thinking.

Create abstractions to communicate intent to your fellow programmers.

Teaching is a great way to determine if you truly understand a subject.

Almost by definition, a suggestion by an LLM represents the least surprising solution.