Code quality
This folder has no README. Everything inside it is listed below.
Notes
- Formatters 4 Formatting is a solved problem. The only wrong answer is "we discuss it in review".
- Linters and static analysis 5 Catching bugs before review. In 2026 the Python answer consolidated onto one tool.
- Type-Checking Strategy 6 Type hints aren't just documentation — adopted well, they're a static safety net that catches a whole class of bugs before runtime.
- Pre-commit Hooks and Code Review 6 The two gates between "code written" and "code merged." Pre-commit catches the mechanical stuff automatically; review catches the judgment stuff.
- Refactoring 6 Changing the structure of code without changing its behavior.
- Technical Debt and Complexity 6 Senior engineers don't just write code — they manage the health of a codebase over time.
- Docstrings and documentation 5 Job descriptions that say "documentation (Google-style docstrings)" are asking whether you write for the next reader.