Haggus & StooklesClear notes on systems, software, and the work behind them.

Maintainability is key to long-term success. Clear code reduces bugs and accelerates onboarding for new developers.

Principles of Clean Code

Meaningful names and consistent formatting improve readability and developer comprehension.

Small, focused functions make logic easier to follow and reuse.

Writing Descriptive Comments

Comments should explain why code exists, not what it does, which should be clear from the code itself.

Avoid redundant or outdated comments to prevent confusion and misinformation.

Refactoring Regularly

Continuous improvement of code through refactoring addresses technical debt incrementally.

Unit tests increase confidence that refactoring does not break functionality.

Collaborative Code Reviews

Peer reviews expose code to fresh eyes, catching issues and sharing knowledge across teams.

Constructive feedback in reviews fosters an inclusive culture of quality.

New posts, occasionally

Stay up to date across engineering, security, and product craft.

medium
↑ Top