rust-lang / rust-lang/rust-by-example

Brazilian Portuguese Translation

Open
#2,015 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Handlebars
Stars
8.1k
Forks
1.6k
PR merge metrics
No merged PRs in 30d

Description

Add Brazilian Portuguese Translation Guide Documentation

This issue tracks the addition of documentation for Brazilian Portuguese contributors who want to translate Rust by Example using the mdbook-i18n-helpers workflow.

Related PR:

Summary

The proposed documentation introduces a complete translation workflow guide for Brazilian Portuguese contributors, including:

  • Installation and setup of required translation tools
  • Commands for creating and updating translation files
  • Instructions for managing translation resources
  • Guidance for compiling the translated book locally
  • Translation progress tracking recommendations
Integration Details

The guide also documents how to properly register new language translations across the project configuration, including updates to:

  • .github/workflows/rbe.yml
  • theme/head.hbs
  • src/bootstrap/src/core/build_steps/doc.rs
Motivation

Currently, there is limited onboarding documentation for contributors interested in translating Rust by Example into Brazilian Portuguese. This guide helps standardize the workflow and lowers the barrier for new translators contributing to the project.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review related PR #2014 first, then inspect .github/workflows/rbe.yml, theme/head.hbs, and src/bootstrap/src/core/build_steps/doc.rs for existing translation registration. The documentation is done when it covers tool setup, translation-file commands, resource management, local book compilation, progress tracking, and the required registration steps for Brazilian Portuguese contributors.

Written by the indexing model from the issue text.

Assessment

Tech stack
handlebars, rust
Domain
documentation, internationalization, localization
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.