Coding Guidelines

These rules apply to every file touched, regardless of language or context. When in doubt: would a senior engineer who hates noise approve this?

Universal rules

No comments in code

Code must be self-explanatory through naming. Remove all comments that restate what the code does. The only acceptable documentation is a module-level docstring when a file's purpose is non-obvious, or a one-line docstring on a public API that cannot speak for itself.