🥓Э
а если камера подключена к общегородской системе видеонаблюдения? кейс москвы
Тег оператор, скорее всего
Size: a a a
2020 April 13
AZ
Коллеги, вы программисты лучше чем я, посоветуйте годный мануал по составлению документации к проекту. Два месяца не открывал код, а сейчас ощущение, будто меня послали коллайдер чинить, при том, что с кодом, рефакторингом и комментариями все в порядке. Речь даже не столько про код, сколько про логику вычислений (пишу редактор, там дофига тригонометрии, матриц и полиномиальных преобразований).
что-нить типа doxygen для составления референса по коду?
🥓Э
что-нить типа doxygen для составления референса по коду?
Скорее нехватка комментов к коду с формулами
AZ
ну это я как вариант привожу, пишется к каждой функции описание что и зачем она делает
SA
что-нить типа doxygen для составления референса по коду?
Не поможет. Если там "с кодом, рефакторингом и комментариями все в порядке", а всё равно непонятно - то автоматизированные средства не спасут, тут поможет только написание внятного документа по общей архитектуре и функционированию кода. Но хорошо написать его смогут немногие и только те, кто уже разобрался в том как код работает.
AZ
помню во времена молодости делал для зачёта интерполяцию с QR-разложением, там у меня была функция с 12 аргументами сложносочинённого смысла... которая вызывалась в 6 разных частях алгоритма...
препод очень плохо относился к C++, но некоторые студенты именно QR-разложение продавили у него с классами, потому что реально адово писать на чистом C такое
препод очень плохо относился к C++, но некоторые студенты именно QR-разложение продавили у него с классами, потому что реально адово писать на чистом C такое
🥓Э
Не поможет. Если там "с кодом, рефакторингом и комментариями все в порядке", а всё равно непонятно - то автоматизированные средства не спасут, тут поможет только написание внятного документа по общей архитектуре и функционированию кода. Но хорошо написать его смогут немногие и только те, кто уже разобрался в том как код работает.
Bn
Коллеги, вы программисты лучше чем я, посоветуйте годный мануал по составлению документации к проекту. Два месяца не открывал код, а сейчас ощущение, будто меня послали коллайдер чинить, при том, что с кодом, рефакторингом и комментариями все в порядке. Речь даже не столько про код, сколько про логику вычислений (пишу редактор, там дофига тригонометрии, матриц и полиномиальных преобразований).
ЕСПД ГОСТ 19.ХХХ-ХХ
S
если функция делает какую-то трансфигурацию, и в процессе вызывает функцию для гомогенизации, хрен какая документация поможет )
S
можно повставлять ссылок на википедию, при условии, что в ней это описано, но если программист не математик — не поможет и это
AZ
ЕСПД ГОСТ 19.ХХХ-ХХ
Писал я на этом как-то документацию... Кг/ам...
AZ
на самом деле попытки описывать что делают функции могут мотивировать аккуратнее структурировать программу и давать этим функциям более внятные имена
Bn
Писал я на этом как-то документацию... Кг/ам...
Что есть кг/ам?..
🥓Э
на самом деле попытки описывать что делают функции могут мотивировать аккуратнее структурировать программу и давать этим функциям более внятные имена
У него проблема не в именах, а описании процесса происходящей там магии. Насколько я понял
AZ
Что есть кг/ам?..
выражение отвращения из падонкафского сленга, считается, что расшифровывается как вот тут выше написали уже
Bn
Трансформация в падонка?)
🥓Э
Трансформация в падонка?)
Пффф... Ты ещё шушпанчегов не встречал)
Bn
Писал я на этом как-то документацию... Кг/ам...
Ну смысл на самом деле не в том чтобы полностью ее придерживаться, а чтобы в какой-то момент понять как оно происходит и переписать по-правильному. Если же идей не пришлось то писать доку дальше
Я в какой-то момент понял пользу диаграммок. Построю и закину в папочку. Есть не просят а план уже есть. И другому потом полегче будет
Я в какой-то момент понял пользу диаграммок. Построю и закину в папочку. Есть не просят а план уже есть. И другому потом полегче будет
AZ
ЕСПД это чистый канцелярит, не надо про него вспоминать
AZ
там отдельный ГОСТ приводит правильные термины с синонимами, которые применять нельзя