Исходное сообщение
"Выпуск языка программирования Rust 1.54" Отправлено n00by, 30-Июл-21 08:30
> Почему бы не собирать доки сразу из отдельного файла с доками? > Зачем в исходники то тянуть что попало из каких-то файлов? Потому что процесс под названием "комментировать код" является приёмом реверс-инженерии. Когда разработка прямая, сначала формулируются требования к коду, а потом уже сам код. Когда требования и код расположены рядом, проще сохранять их соответствие. Таким образом возникли doxygen и подобные системы. Потом уже в них добавили опцию "вот этот файлик хорошо бы целиком включить в документацию".