Я заметил, что многие известные проекты с открытым исходным кодом редко содержат значительное количество комментариев и встроенной документации. Учитывая, что основная цель комментирования состоит в том, чтобы прояснить, что делает код без необходимости читать и понимать каждую строку, мне кажется странным, что это будет иметь место, тем более что эти проекты поощряют участие сообщества новичков, которые могут не сразу понять все нюансы.
Для меня это вызывает вопрос: существует ли какая-либо производительность ( или другая практическая причина ) из-за отсутствия документации? Я могу придумать пару возможных причин, но ни одна из них не удовлетворяет меня полностью:
- Время компиляции можно улучшить, не обрабатывая лишние строки
- Авторы не хотели писать документацию ( или просто не хотели дополнительного беспорядка из большего количества строк и символов, которые напрямую не улучшают функциональность )
ПРИМЕЧАНИЕ : я знаю, что этот вопрос, возможно, решается на субъективность, но я чувствую, что он подпадает под категорию " вдохновляющих ответов, которые объясняют" почему »и« как »» описано на странице справки .