The Module Docstring Linter #
This file implements a linter that enforces module docstring hygiene:
- Missing module docstring: warns when a file has no
/-! ... -/block at all (detected on the first non-moduleDoccommand). - Duplicate module docstrings: warns when a file has more than one
/-! ... -/block (subsequent blocks should be regular/- ... -/comments).
The module docstring linter checks two things:
- A file that has no
/-! ... -/block gets a warning on its first non-moduleDoccommand. - A file that has more than one
/-! ... -/block gets a warning on each extra block.
Equations
- One or more equations did not get rendered due to their size.