Как стать автором
Обновить

Комментарии 5

Проверьте всё, что изменилось в Rust, Cargo и Clippy.

В Clippy очень радуют краткие и понятные примеры кода в правилах. Я его раньше почти не использовал. Походу, зря.

В который раз подмечаю, что у Rust встроенные инструменты довольно продуманные и удобные. Помню, кайфовал с того, как классно `cargo doc` "из коробки" генерит авто-документацию. В Python и JS с этим пришлось помучаться.

А чем генерили? Я в своё время тоже помучался со sphinx, а вот с java было довольно легко всё сгенерить, видимо, всё из-за того, что документирующие комментарии к python прикручивали с боку и стандартной тулы для них нет, кажется в JS похожая ситуация

sphinx-apidoc с плагином autodoc и пришлось заморочиться с конфигом, чтобы он работал с Django и адекватно документил модели. Но всё равно получилось не совсем так, как хотелось.

sphinx-apidoc с плагином autodoc

Я дважды настраивал, второй раз попроще, но всё равно повозиться приходится.

Зарегистрируйтесь на Хабре, чтобы оставить комментарий

Публикации