Ну я ж говорю, в серьезных конторах так.

Угу

Когда в банке работал - там почти каждая задача диаграммами и блок схемами описывалась, сейчас в аутсорсе - блок схем нет вообще)

А потом чёрт ногу сломит понимать, что в проекте происходит)

Есть специальная штука для подобного документирования: https://plantuml.com/ru/

У нас в фаангах так не принято.

а uml?

Эт что?

Это семпл с двумя прямоугольниками по стандарту.

Я в политехе. Устаревшее образование и каша из знаний, большая часть которых не пригодится.

Ну, так в вузе дают больше комплексный подход к решению задач, развивают способность к обучению, расширяют кругозор и тд. Узконаправленное изучение определенного япа мб где-то и есть, но не в вузе широкого профиля. Есть стандарт образовательной программы по подготовке инженеров (напр по специальности 09.03.01 - информатика и вычислительная техника). И логично, что людей учат не узким "практическим навыкам" уровня "как забить гвоздь", а учат подходу в целом - виды соединений (помимо соединения на гвоздях), сопротивление материалов, виды нагрузки и тд, чтобы специалист понимал что он делает, для чего, является ли этот способ оптимальным, расчитал запасы прочности, ведь от всех этих действий будут зависеть другие люди (и иногда вплоть до жизней других людей). Да, можно "просто учить забивать гвоздь". Это будет работать и для каких-то задач пойдёт. Но говорить, что так и надо делать всем, "это устаревший подход и бесполезные знания" я б не стал.

Плохо понимаю английский что там насчет картинок в латексе? Можно этих же баб но в латексе посмотреть? А это точно про документацию сайт?

а uml?

Возможно в пресс-релизах каких-нибудь, во внутренней документации если есть схема - это уже хорошо.

Эт что?

Это скрин с того сайта)

Это скрин с того сайта)

Видимо, у кого-то адблока нет.

Возможно в пресс-релизах каких-нибудь, во внутренней документации если есть схема - это уже хорошо.

ну да я и имел ввиду для внешнего потребления

Это скрин с того сайта)

ну да я и имел ввиду для внешнего потребления

Мы ж не госкомпания, чтобы тратить свое время на uml-диаграммы.

Видимо, у кого-то адблока нет.

Профессиональный софт! Без адблока не входить!)

У меня вообще ссылка не открывается

Мы ж не госкомпания, чтобы тратить свое время на uml-диаграммы.

У меня минут 5 уходит.

У меня вообще ссылка не открывается

А если так: https://plantuml.com/en/ ?

У меня минут 5 уходит.

Ну не все ж сеньор-юмл-программисты.

У меня минут 5 уходит.

а выхлоп от этого?

А если так: https://plantuml.com/en/ ?

Так если домен не находит, какая разница какой URI?

Ну не все ж сеньор-юмл-программисты.

Про тесты также говорят. А на деле, что uml, что тесты очень сокращают время в перспективе.

а выхлоп от этого?

Я отдаю апишку и не объясняю ничего никому по 100500 раз. А если через год придётся мне (или ещё кому-нибудь) что-то переделывать, я меньше времени будет вникать.

Я отдаю апишку и не объясняю ничего никому по 100500 раз. А если через год придётся мне (или ещё кому-нибудь) что-то переделывать, я меньше времени будет вникать.

понял

Так если домен не находит, какая разница какой URI?

А, ошибку не прочитал. Тогда странно.

Я отдаю апишку и не объясняю ничего никому по 100500 раз. А если через год придётся мне (или ещё кому-нибудь) что-то переделывать, я меньше времени будет вникать.

Все это шикарно до момента внесения изменений. Особенно когда нада вчера. И да мы из тех компаний где так бывает)

Все это шикарно до момента внесения изменений. Особенно когда нада вчера. И да мы из тех компаний где так бывает)

Никогда не понимал таких компаний. С внесением изменений тоже всё норм. Прочитал, починил, поправил.

Какой нахер умл продакт лег... Дада ща прийдет Андрий и скажет что это все не правиль Но о и так быть не должно)

Никогда не понимал таких компаний. С внесением изменений тоже всё норм. Прочитал, починил, поправил.

)

Какой нахер умл продакт лег... Дада ща прийдет Андрий и скажет что это все не правиль Но о и так быть не должно)

Не придёт, там ещё 7:39

Никогда не понимал таких компаний. С внесением изменений тоже всё норм. Прочитал, починил, поправил.

Да второй вариант... Бага в продакте... Окей следующий релиз через две недели вы в него не попадаете, может быть через месяц пофиксим) но это не точно. Ибо воркфлоу это святое и умл надо перерисовать. У вас так?)

Ведь давайте откровенно или первое или второе. У нас нет ошибок это не достижимый идеал.

Да второй вариант... Бага в продакте... Окей следующий релиз через две недели вы в него не попадаете, может быть через месяц пофиксим) но это не точно. Ибо воркфлоу это святое и умл надо перерисовать. У вас так?)

uml - абстракция. Если в коде баг - uml от него не зависит вообще. uml общую логику описывает.

Код покрывать схемами - маразм.

Мы из разных вселенных проехали)

Uml про архитектуру же а не кодинг

Да второй вариант... Бага в продакте... Окей следующий релиз через две недели вы в него не попадаете, может быть через месяц пофиксим) но это не точно. Ибо воркфлоу это святое и умл надо перерисовать. У вас так?)

Ну а так, есть бага, она правится в меру критичности. Если нужно поправить документашку - она сразу правится (я не знаю, что должна быть за бага, чтобы нужно было на исправление документации тратить дольше 10 минут).

Ну и в крайнем случае всегда можно доделать после исправления бага.

Про тесты также говорят. А на деле, что uml, что тесты очень сокращают время в перспективе.

Тесты да, а UML как сокращает?

Ну а так, есть бага, она правится в меру критичности. Если нужно поправить документашку - она сразу правится (я не знаю, что должна быть за бага, чтобы нужно было на исправление документации тратить дольше 10 минут).

Идея не во времени, а в том что актуализация сопутствующей информации не является точкой отказа, а значит ее можно (у)пропустить.

Тесты да, а UML как сокращает?

Я там же написал.

Тесты да, а UML как сокращает?

имхо при анбординге UML помогает сильно

Сколько я не смотрел API, ни разу не видел UML диаграм :)

Про тесты также говорят. А на деле, что uml, что тесты очень сокращают время в перспективе.

Сильно зависит от тестов. В целом, вообще никак не сокращают в общем слуаче, а скорее наоборот.

имхо при анбординге UML помогает сильно

Был опыт или чисто теоретически?

Идея не во времени, а в том что актуализация сопутствующей информации не является точкой отказа, а значит ее можно (у)пропустить.

Ну, как по мне, накидать uml проще, чем прочитать текст.

Сильно зависит от тестов. В целом, вообще никак не сокращают в общем слуаче, а скорее наоборот.

Вопрос к тому, кто писал тесты и с какой целью.

Вообще, если для того, чтобы понять как работает API, надо читать UML диаграммы то... есть большие вопросы к API :)

Умл может не соответствовать действительноси, а код это сама действительность.

Ну, как по мне, накидать uml проще, чем прочитать текст.

Мне проще посмотреть на example.

Вопрос к тому, кто писал тесты и с какой целью.

Не вижу связи между личностью написавшего и фактом тестов.

Был опыт или чисто теоретически?

ну было такое что мне сложно было на проекте разобраться зачем куча солюшенов и их связи, мне было бы проще посмотреть на схемы чтоб примерно картину понять

Умл может не соответствовать действительноси, а код это сама действительность.

Давай тогда не писать ни тесты, ни документацию. Будет просто код.

Умл может не соответствовать действительноси, а код это сама действительность.

Проще просто делать автогенераицю сваггера какого-нибудь.

Давай тогда не писать ни тесты, ни документацию. Будет просто код.

Бинго. Ты тоже к этому пришел?

Давай тогда не писать ни тесты, ни документацию. Будет просто код.

Ну, иногда тесты не нужны. Если там совсем примитивщина - зачем?

Не вижу связи между личностью написавшего и фактом тестов.

Если пишет некомпетентный разработчик - от тестов будет вред.

Ну, иногда тесты не нужны. Если там совсем примитивщина - зачем?

Ну так и не надо всё покрывать тестами.

Проще просто делать автогенераицю сваггера какого-нибудь.

Именно дока должна актулизироваться желательно без человеческого фактора, а иначе это жопа

ну было такое что мне сложно было на проекте разобраться зачем куча солюшенов и их связи, мне было бы проще посмотреть на схемы чтоб примерно картину понять

Я как-то пытался разобраться в LLVM. Там было куча UML, и я понял, что не хочу работать в этом проекте :) Типа такого https://llvm.org/doxygen/classllvm_1_1cl_1_1SubCommand.html В остальном прекрасно онбордился и без UML

Если пишет некомпетентный разработчик - от тестов будет вред.

А код-ревью на что?

А код-ревью на что?

Это тут при чём?

Я как-то пытался разобраться в LLVM. Там было куча UML, и я понял, что не хочу работать в этом проекте :) Типа такого https://llvm.org/doxygen/classllvm_1_1cl_1_1SubCommand.html В остальном прекрасно онбордился и без UML

ох ежик....

Я как-то пытался разобраться в LLVM. Там было куча UML, и я понял, что не хочу работать в этом проекте :) Типа такого https://llvm.org/doxygen/classllvm_1_1cl_1_1SubCommand.html В остальном прекрасно онбордился и без UML

Ну это задница, конечно.

Давай тогда не писать ни тесты, ни документацию. Будет просто код.

Тесты понятно зачем, экзотичекий вариант верифицируемого кода пока что экзотический. Документация... Ну такое... обычно немного вначале помогает, хотя больше смотришь в examples и просто осмотреть, а что там такого вообще есть. Если для либ, а не для хитрых ЯП... Но потом всё равно проще смотреть исходники...

Ну это задница, конечно.

Как же ты на Гоголя похож, глаз от авы не оторву

Умл хорош когда нада заказчику обосновать куда делось бабло)

Ну это задница, конечно.

Это самое простое нагуглил, а там были простыни поболее... Например, в несколько раз больше этой https://llvm.org/doxygen/structllvm_1_1WinEHFuncInfo.html

Так дохуген же)

Так дохуген же)

Ну да, куча диаграмм, актуализированных, но непонятно какой в них толк. И чем это проще исходников

Ну да, куча диаграмм, актуализированных, но непонятно какой в них толк. И чем это проще исходников

Это как данность, кто то решил что умл это круто, другой кто то решил что умл это херня и вместо чтобы рисовать их прикрутил автогенерацию это чтобы таким как Летов спалось спокойно)

Это как данность, кто то решил что умл это круто, другой кто то решил что умл это херня и вместо чтобы рисовать их прикрутил автогенерацию это чтобы таким как Летов спалось спокойно)

Каждый инструмент нужно использовать правильно.

А то что конечному юзеру нужно похер и первому и второму) главное умл есть? Есть)

Каждый инструмент нужно использовать правильно.

просто есть обоснованное использование и не обоснованное)

Именно дока должна актулизироваться желательно без человеческого фактора, а иначе это жопа

Так оно и обновляется автоматически при билде каждый раз.

Каждый инструмент нужно использовать правильно.

Если у тебя есть микроскоп это не значит что он нужен в каждом твоем проекте. Где то умл может быть и нужен, а где то ну его нахер

Это тут при чём?

К тому, что тесты низкого качества от некомпетентного разработчика не попадут в репозиторий.

Так оно и обновляется автоматически при билде каждый раз.

Да я понимаю, я и говорю что это здоровый путь.

К тому, что тесты низкого качества от некомпетентного разработчика не попадут в репозиторий.

В идеальном мире ты живёшь.

В идеальном мире ты живёшь.

А когда ты нам про умл рассказываешь то нет? У тебя двойные стандарты)