Sobre el proyecto

Este repositorio contiene la fuente de "El Lenguaje de Programación Rust", el libro introductorio canónico para el lenguaje Rust. El libro terminado se publica impreso por No Starch Press y también está disponible gratuitamente en línea, distribuido junto con las versiones estable, beta y nocturna de Rust (aunque esas copias incluidas pueden quedar rezagadas respecto a las correcciones hechas aquí). Una página de versiones proporciona código descargable para todos los listados que aparecen en el libro. El libro está escrito en Markdown y se renderiza con mdBook, el generador de sitios estáticos para libros de la comunidad Rust. Para compilarlo se requiere instalar una versión específica de mdBook (que coincida con la fijada en la herramienta rustbook de rust-lang/rust) mediante `cargo install mdbook --locked --version <número_de_versión>`, y luego ejecutar `mdbook build` para producir un sitio estático en el subdirectorio `book`, visible en cualquier navegador. El README documenta comandos de lanzamiento de navegador para Firefox y Chrome en Linux, macOS y Windows (tanto PowerShell como Cmd). Las pruebas para los ejemplos de código residen en `packages/trpl` y se ejecutan con `mdbook test --library-path packages/trpl/target/debug/deps`. Las contribuciones son bienvenidas a través de las pautas en CONTRIBUTING.md, pero debido a que el libro se imprime y los mantenedores buscan mantener la versión en línea cercana a la edición impresa, las revisiones se agrupan en torno a los lanzamientos de ediciones de Rust. Entre esas revisiones mayores, solo se fusionan correcciones estrictas de errores, por lo que las solicitudes de extracción que no sean de errores pueden esperar meses o años. Las traducciones se rastrean mediante una etiqueta de Traducciones y los nuevos esfuerzos de idioma pueden abrirse como problemas, aunque la fusión espera el soporte multilingüe de mdBook. Un script `ci/spellcheck.sh` más un diccionario `ci/dictionary.txt` apoyan la revisión ortográfica, con falsos positivos (como identificadores tipo `BTreeMap`) añadidos al diccionario en orden ordenado. En general, este es un proyecto de documentación y educativo más que una herramienta de ejecución: su valor para los usuarios es como el recurso de aprendizaje autoritativo para Rust, con un pipeline de compilación bien documentado, un entorno de pruebas para ejemplos de código y un flujo de trabajo estructurado de contribución y traducción.