## docs | dev
Зачастую в rust проектах есть ссылка на docs.rs с документацией. Но гораздо реже можно встретить документацию напрямую из "
На днях нашёл удобный способ как автоматически, бесплатно и без смс билдить и выкладывать документацию своего крейта!
Итак, по порядку:
1. зарегистрируйтесь на netlify
2. найдите и нажмите на кнопку "new site from git"
3. подключите github/gitlab/bitbucket
4. выберите ветку
5. устанавливите в build command что-то вроде "
6. устанавливите в publish directory "
7. Domain settings -> Custom domains [options] -> edit site name -> выбирите имя поддомена (например по имени вашей библиотеки)
[8.] Добавляете в
Готово, теперь у вас всегда есть документация из последних исхоников! #rust
Зачастую в rust проектах есть ссылка на docs.rs с документацией. Но гораздо реже можно встретить документацию напрямую из "
dev" ветки. Особенно этого не хватает когда крейт ещё не был выложен на crates.io (и следовательно его доки нет на docs.rs).На днях нашёл удобный способ как автоматически, бесплатно и без смс билдить и выкладывать документацию своего крейта!
Итак, по порядку:
1. зарегистрируйтесь на netlify
2. найдите и нажмите на кнопку "new site from git"
3. подключите github/gitlab/bitbucket
4. выберите ветку
5. устанавливите в build command что-то вроде "
curl https://sh.rustup.rs -sSf | sh -s -- -y --default-toolchain nightly --profile minimal && source $HOME/.cargo/env && RUSTDOCFLAGS="--cfg docsrs" cargo +nightly doc --no-deps --features concat"6. устанавливите в publish directory "
target/doc"7. Domain settings -> Custom domains [options] -> edit site name -> выбирите имя поддомена (например по имени вашей библиотеки)
[8.] Добавляете в
README.md значёк: [](https://yourlib.netlify.com/yourlib)
Готово, теперь у вас всегда есть документация из последних исхоников! #rust
мне не нравится реальность pinned «Выложил arraylib на crates.io ¯\_(ツ)_/¯»
Каждый раз, когда ты принимаешь Vec<T> по ссылке, где-то в мире ругается один Клиппи