Взял на доработку чужой проект, и гневу просто нет предела. Наверняка это каждому знакомо, когда заходишь в исходники, а понять каким образом это всё работает не получается. Иногда встречаются какие либо комментарии над каждой функцией, но, по мне это всё равно, что на 4 стенах написать в какую сторону они смотрят(север-запад-.. и тд), а чтоб узнать, надо к каждой стенке подойди и прочитать, а тем временем забываешь в какую сторону смотрела прошлая стена. Что, есть комментарий, что нет его, один хер разница. (помогают только в случае описание переменных в принимаемой функции)
Некоторые из вас работают в компаниях, которые разрабатывают большие проекты, над которым работают значительное количество групп и людей состоящих в них. И одними комментариями над функциями недостаточно. Наверняка существует какая либо документация о написанных функциях и алгоритмах. Я себе представляю, что есть какой-то документ в которых есть главы на подобие:1) Настройки программы: описание 2) Файлы с которыми работает программа 3) Алгоритм обработки данных с базы данных и т.д.
Меня интересует по какому доп. стандарту создается этот фаил, что и как в нем описано.
