DF
У вас техписы прям в код лезут доккоменты вставлять?
Size: a a a
2020 November 14
CD
Dollar Føølish
У вас техписы прям в код лезут доккоменты вставлять?
Емнип в JetBrains еще в половину требований джуна Java/Kotlin были вакансии
DF
Хех
CD
Dollar Føølish
У вас техписы прям в код лезут доккоменты вставлять?
вот скажем объявление на вакансию из облака
https://yandex.ru/jobs/vacancies/cont_man/content_editor_cloud/
можете посмотреть третий вопрос в списке :)
https://yandex.ru/jobs/vacancies/cont_man/content_editor_cloud/
можете посмотреть третий вопрос в списке :)
TS
Dollar Føølish
Тимур а можно вам в ЛС написать?
Можно
DF
Спасибо , напишу
TS
Я вчера попробовал, и мне не понравилось
Как я понял, Doxygen умеет то же самое что и Sphinx+Breathe+Exhile, их единственный плюс - красивые темы оформления. Минусы: страницы подлагивают из-за обилия js, куча доп зависимостей для создания документации, поломка не http форматов (не то чтобы они были особо нужны, но осадочек остался)
Как я понял, Doxygen умеет то же самое что и Sphinx+Breathe+Exhile, их единственный плюс - красивые темы оформления. Минусы: страницы подлагивают из-за обилия js, куча доп зависимостей для создания документации, поломка не http форматов (не то чтобы они были особо нужны, но осадочек остался)
Основная претензия у доксигену - стиль веб сайта 20летней давности. Сфинкс с readthedocs темой позволяет это исправить. К сожалению Breathe(ссылки на Доксиген) надо кропотливо интегрировать в RST и много ручной работы за пределами доксиген блоков, и Exhale как-то это не решает. Но
Всё привыкли к readthedocs теме, и игра стоит свеч
Всё привыкли к readthedocs теме, и игра стоит свеч
TS
+ есть сомнения, что техписы знакомы с doxygen и как его вкорячивать
+ не хочется использовать Яндексовые внутренние инструменты. Документация должна быть генерируема и за пределами Я
+ не хочется использовать Яндексовые внутренние инструменты. Документация должна быть генерируема и за пределами Я
Техписы умеют в RST, это часть их профессии
ID
@antoshkka, а у вас используют conan/vcpkg?
Так их любят почему-то в этом чатике
Так их любят почему-то в этом чатике
AM
@antoshkka, а у вас используют conan/vcpkg?
Так их любят почему-то в этом чатике
Так их любят почему-то в этом чатике
если посмотреть исходники ClickHouse, то там видно, что все зависимости подключаются через CMake и выкачиваются через github submodules
AM
и не все их любят)
ID
и не все их любят)
Не все любят конаны, или сабмодули?
AM
насколько я знаю, в яндексе есть своя утилита для сборки)
ID
насколько я знаю, в яндексе есть своя утилита для сборки)
Я так понял, conan/vcpkg это больше про менеджер пакетов в первую очередь
D
если посмотреть исходники ClickHouse, то там видно, что все зависимости подключаются через CMake и выкачиваются через github submodules
А если смотреть исходники CatBoost, то там на yamake, если я правильно понимаю
DF
Катбуст разве Яндекс
AM
А если смотреть исходники CatBoost, то там на yamake, если я правильно понимаю
ну, отростки yamake есть и в ClickHouse
D
ну, отростки yamake есть и в ClickHouse
Ну там это больше как чтобы оно просто в Яндексовской монорепе лежало и отображалось, а в CatBoost там вроде часть логики по сборке есть