Documentation
README
Plain language in code
Extends ISO 24495-1 to source code. Code is read far more often than it is written, so the person reading it is the reader the standard is about.
Scope. This skill governs what a reader reads: the order units appear in, what they are called, what the comments say, and what an error tells the person who hits it.
It does not govern correctness, performance, or system design. It does govern local organisation, in rules 1 and 2, because where a unit sits and how far it reaches decide what a reader must hold in their head. For maintainability weaknesses such as complexity and dead code, use a code quality skill built on ISO/IEC 5055.
This is an interpretation of ISO 24495-1 applied by analogy, not a conformance claim.
The four principles, in code
This is the opening of the README. Read the full README on GitHub.