Цифровые Мысли

Код - это код, комментарии - это комментарии, документация - это документация. Все нужно, у всего свои задачи и свои читатели. Нужна общая архитектурная диаграмма, которая бы объясняла базовые принципы построения системы, основные блоки и взаимодействие между ними, желательны SoWы для разработки новых фичей, нужны javadocs, нужны паттерны и best practiсes для типовых расширений... Сравнивать архитектурные документы с "трекерами с тикетами" совершенно неверно - это разные виды документации, предназначенные для разных целей. В помойке из нескольких сотен тысяч тикетов можно найти нужную информацию только при том условии, что архитектура системы у тебя в голове. Если ты не видишь общей картины, информация о том, что какую-то строчку кода закомментировали из-за такого-то бага, бессмысленна...