Я перестал копировать код в документацию, храня тесты, код и прозу в одном Markdown-файле
Literate programming поддерживает синхронизацию документации, тестов и реализации, делая Markdown-файл единственным источником правды. Вот как реализовать это тридцатью строками на Python.