Документация Rust - отсутствуют некоторые листинги

[Sega100500]

Здравствуйте

Я начал изучение языка Rust, но сталкиваюсь с тем, что в документации на русском некоторые листинги программ отсутствует, что сбивает с толку.
Например, в главе:
https://doc.rust-lang.ru/book/ch12-03-improving-error-handling-and-modularity.html

обратите внимание на раздел "Разделение кода на библиотечный крейт"
там как раз отсутствует очень важная часть, а листинг "Листинг 12-13. Перемещение Config и run в src/lib.rs" содержит только обрывок кода.
И до этого в некоторых предыдущих главах так же есть пустые листинги.

При изучении языка очень важно знакомиться с полной и корректной документацией, иначе такое отчасти наплевательское отношение может оттолкнуть новичков.

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

Как ни крути, а маркетинг для языков программирования тоже существует - важна качественная подача материала именно в момент знакомства с языком, изучения. Чтобы потом не было удивления "вроде и язык хорош, а интереса к нему не проявляют".

[rusment]

привет.
в этом PR исправлял блоки кода - #1408
можешь собрать локально её у себя через mdbook build (в англ. репе есть полный алгоритм)

[Sega100500]

привет. в этом PR исправлял блоки кода - #1408 можешь собрать локально её у себя через mdbook build (в англ. репе есть полный алгоритм)

Спасибо! Я то сам в итоге этот код написал - не проблема. Я больше о том, что на официальном сайте всё так.

[rusment]

привет. в этом PR исправлял блоки кода - #1408 можешь собрать локально её у себя через mdbook build (в англ. репе есть полный алгоритм)

И, кстати, да. Подскажите пожалуйста ссылку, где скачать документацию (исправленную) на русском? И можно ссылку на оригинальный репозитарий, где описано как подготовить эту документацию, например, на сайте?

Спасибо

исправленная в том PR (он из этой репы, где я правки вносил - https://github.com/rusment/rustbook).

вот оригинальный репозиторий - https://github.com/rust-lang/book (в редми есть про сборку). чтобы выгрузить её, например, на сайт, то просто берём собранную статику (html и прочее) из директории, куда собралась дока и в nginx уже по-классике root /srv/public/html/docs/;

[Sega100500]

И далее по тексту:
https://doc.rust-lang.ru/book/ch12-05-working-with-environment-variables.html

В разделе "Реализация функции search_case_insensitive" с листингами вообще бардак!
В листингах 12-22 и 12-23 вообще один и тот же код, но совершенно не тот, который должен быть, не тот, о котором говорится в тексте.
Нет кода про использование переменной окружения.
Абзац: "Отлично! Тесты прошли. Теперь давайте вызовем новую функцию search_case_insensitive из функции run. Во-первых, мы добавим параметр конфигурации в структуру Config для переключения между поиском с учётом регистра и без учёта регистра. Добавление этого поля приведёт к ошибкам компилятора, потому что мы ещё нигде не инициализируем это поле:"

и далее после него листинги программ вообще не те.

[Sega100500]

https://doc.rust-lang.ru/book/ch13-03-improving-our-io-project.html

листинги 13-17, 13-19, 13-20 некорректные

[brmn344]

Листинг 9.13 отсутствует

[Sega100500]

Глава 17 "Fundamentals of Asynchronous Programming: Async, Await, Futures, and Streams" в русской документации отсутствует, но при этом все последующие главы "съехали по номерам на -1", соответственно, нет листингов во всех следующих главах, видимо, из-за несоответствия номеров.