Sobre o projeto

Este repositório contém a origem de "The Rust Programming Language", o livro introdutório canônico para a linguagem Rust. O livro finalizado é publicado em formato impresso pela No Starch Press e também está disponível gratuitamente online, sendo distribuído junto com as versões stable, beta e nightly do Rust (embora essas cópias empacotadas possam estar desatualizadas em relação às correções feitas aqui). Uma página de releases fornece código para download de todas as listagens que aparecem no livro. O livro é escrito em Markdown e renderizado com o mdBook, o gerador de sites estáticos para livros da comunidade Rust. Para construir, é necessário instalar uma versão específica do mdBook (correspondente à versão fixada na ferramenta rustbook do rust-lang/rust) via `cargo install mdbook --locked --version <version_num>`, e então executar `mdbook build` para produzir um site estático no subdiretório `book`, visualizável em qualquer navegador. O README documenta comandos de abertura de navegador para Firefox e Chrome em Linux, macOS e Windows (tanto PowerShell quanto Cmd). Testes para os exemplos de código ficam em `packages/trpl` e são executados com `mdbook test --library-path packages/trpl/target/debug/deps`. Contribuições são bem-vindas por meio das diretrizes do CONTRIBUTING.md, mas como o livro é impresso e os mantenedores visam manter a versão online próxima à edição impressa, as revisões são agrupadas em torno dos lançamentos de Edições do Rust. Entre essas revisões maiores, apenas correções estritas de erros são mescladas, então pull requests que não são de erros podem esperar meses ou anos. Traduções são rastreadas por meio de um rótulo Translations e novos esforços de idioma podem ser abertos como issues, embora a mesclagem aguarde o suporte multilíngue do mdBook. Um script `ci/spellcheck.sh` e um dicionário `ci/dictionary.txt` dão suporte à verificação ortográfica, com falsos positivos (como identificadores como `BTreeMap`) adicionados ao dicionário em ordem classificada. No geral, este é um projeto de documentação e educação, e não uma ferramenta de execução: seu valor para os usuários é como o recurso de aprendizado autoritativo para Rust, com um pipeline de build bem documentado, uma estrutura de testes para exemplos de código e um fluxo de trabalho estruturado para contribuições e traduções.