Size: a a a

Rust/Verona LGBTTQQIAAPС++ strikeforce

2020 September 14

EG

Emmanuel Goldstein in Rust/Verona LGBTTQQIAAPС++ strikeforce
В 90% случаев у тебя нет отдельной команды документации
источник

EG

Emmanuel Goldstein in Rust/Verona LGBTTQQIAAPС++ strikeforce
В случаях, когда она у тебя есть, ты можешь просто инклуднуть маркдаун-файл как доккоммент
источник

P

Pavel in Rust/Verona LGBTTQQIAAPС++ strikeforce
Emmanuel Goldstein
В 90% случаев у тебя нет отдельной команды документации
и при этом всё-равно никак не можешь отделить документацию от кода, и она размывает документацию самого кода
источник

EG

Emmanuel Goldstein in Rust/Verona LGBTTQQIAAPС++ strikeforce
Emmanuel Goldstein
В 90% случаев у тебя нет отдельной команды документации
В опенсорсе у тебя в 99.99% случаях нет отдельной команды документации
источник

P

Pavel in Rust/Verona LGBTTQQIAAPС++ strikeforce
Emmanuel Goldstein
В опенсорсе у тебя в 99.99% случаях нет отдельной команды документации
в том числе из-за высокого порога входа для техрайтеров в системы, где у тебя и код и документация в одних файлах, а они видят только папочку doc где картинки для ридми
источник

EG

Emmanuel Goldstein in Rust/Verona LGBTTQQIAAPС++ strikeforce
Можно без особых проблем подключать отдельные маркдаун-файлы в документацию
источник

EG

Emmanuel Goldstein in Rust/Verona LGBTTQQIAAPС++ strikeforce
Был даже какой-то крейт для этого
источник

P

Pavel in Rust/Verona LGBTTQQIAAPС++ strikeforce
Emmanuel Goldstein
Можно без особых проблем подключать отдельные маркдаун-файлы в документацию
там разве не надо в начале каждой строчки писать //! всякие?
источник

EG

Emmanuel Goldstein in Rust/Verona LGBTTQQIAAPС++ strikeforce
Pavel
там разве не надо в начале каждой строчки писать //! всякие?
Через процмакрос можно породить аттрибут #![doc = "smth"], где smth — текст подключённого файла
источник

EG

Emmanuel Goldstein in Rust/Verona LGBTTQQIAAPС++ strikeforce
Кажется, такой процмакрос кто-то уже написал
источник

EG

Emmanuel Goldstein in Rust/Verona LGBTTQQIAAPС++ strikeforce
источник

EG

Emmanuel Goldstein in Rust/Verona LGBTTQQIAAPС++ strikeforce
И ещё есть фича в найтли, которая делает это из коробки
источник

EG

Emmanuel Goldstein in Rust/Verona LGBTTQQIAAPС++ strikeforce
https://github.com/Geal/cargo-external-doc
И вот этот плагин для генерации доков из отдельных файлов
источник

P

Pavel in Rust/Verona LGBTTQQIAAPС++ strikeforce
о, в nom понимают как писать доки
источник

P

Pavel in Rust/Verona LGBTTQQIAAPС++ strikeforce
источник

P

Pavel in Rust/Verona LGBTTQQIAAPС++ strikeforce
источник

ДM

Да Melon in Rust/Verona LGBTTQQIAAPС++ strikeforce
Переслано от Да Melon
Влияет ли зно при поступлении в США или Европу?
источник

ДM

Да Melon in Rust/Verona LGBTTQQIAAPС++ strikeforce
Переслано от Да Melon
Если матеша норм а украинский нет
источник

УМ

Убийца Мамонтов... in Rust/Verona LGBTTQQIAAPС++ strikeforce
∅ ч
хотелось бы нормальный язык, а не high level dynamic language
обоснуй чем он не нормальный?
источник

УМ

Убийца Мамонтов... in Rust/Verona LGBTTQQIAAPС++ strikeforce
хочет фичи высокоуровневого языка в низкоуровневом, нормалбно
источник