Комментарии 7
Отрицание, торг и увольнение с этой помойки.
Ну, я вообще не видел ни одного коммерческого IT-проекта, где была бы хоть какая-то документация. Мэнэджеры не дадут времени её писать, им нужно доставлять фичи
Берешь пишешь документацию в рамках выполнения задачи. Все равно они сейчас вместо часов считают в папугаях разных, также пишем тесты и прочее.
Вот есть у вас задача на 5-7 часов. Добавим 2ч на тесты, 2ч на доку и в таких рамках сами для себя считаем. Менеджеру срем в голову 1-2 попугая, один хрен этот лупень поверит.
я видел. и сейчас работаю на таком.
очень прикольно, когда можешьнайти 90 процентов инфы без камланий.
это, конечно, не путь джедая, но реально вштыривает.
а вот по некоторым решениям, которые мы привлекаем извне документации не то чтобы нет, но она крайне скудная.
тоже вштыривает. но есть нюанс :)
База данных является краеугольным камнем любого проекта.
Посмотрел на несколько последних проектов, в которых участвовал.
SIP софтсвич. Общается с чем-то, представляющим себя как биллинг, по кастомному протоколу (RADIUS с вендорскими расширениями). Ну база тоже есть, но очень вспомогательная.
Компонент радиосоты, управление локальной конфигурацией, которая задаёт направление потоков данных через кастомизированное железо. О "базе данных" можно говорить только в плане состояния этой конфигурации в памяти между ребутами. Есть, конечно, центральная база (на всяких etcd), но это конфигурация, которую в основном правят руками.
Можно продолжать...
Я не против статьи в целом, но слишком много упрощений. И почему мне кажется, что вся статья была написана ради одного слова "Swagger"? И чем же он так хорош, что использовать его, а не 100500 аналогов? "Тема <xxx> не раскрыта" (c).
Неплохо!
Данная статья сподвигнула на подумать о том, когда документации много и это тоже не всегда удобно
Удивительно. Через 50 лет после возникновения системы стандартов документирования процесса проектирования ПО некоторые люди вдруг поняли, что проектировать и разрабатывать ПО, не записывая проектные решения, трудно.
Отрицание, торг и принятие работы над проектом без документации