Translation of the Python Documentation — pa

Punjabi (Gurmukhi) translation of the Python documentation.

This project aims to translate Python's official documentation into Punjabi (Gurmukhi) and make Python learning resources more accessible to Punjabi-speaking developers, students, and educators.

• Status
• Current Progress
• Validation Status
• Recent Milestones
• Infrastructure
• Transifex
• Next Steps
• Goals
• Repository Structure
• Translation Workflow
• References
• Acknowledgements
• License

🎉 Officially recognized — Punjabi (pa) is now listed in the Python Developer Guide Translation Coordinators following the merge of PR #1843.

This repository follows the official Python Documentation Translation workflow and is synchronized with the official Python Documentation Transifex project.

The Punjabi translation project is maintained collaboratively by a team of coordinators using the official Python Documentation Translation infrastructure.

Translation quality is ensured through a combination of:

• shared terminology defined in GLOSSARY.md
• translation conventions described in STYLE_GUIDE.md
• automated validation
• collaborative review through Transifex
• CPython documentation builds

The Punjabi translation project continues to expand through the official Python Documentation Translation workflow.

Translation work is ongoing, with additional Library, HOWTO, FAQ, Reference, C API, and What's New documentation being translated through the official Python Documentation Transifex project.

Validation and translation review are separate processes.

The validation pipeline verifies translation syntax, markup preservation, and documentation build correctness. Human review focuses on terminology consistency, language quality, technical accuracy, and adherence to the project's glossary and style guide.

All completed translations are validated using the same workflow adopted by the Python Documentation Translation community before being merged into the repository.

Translate
      ↓
Transifex
      ↓
GitHub Actions Sync
      ↓
GNU gettext Validation (`msgfmt --check`)
      ↓
sphinx-lint
      ↓
CPython HTML Build
      ↓
Nitpicky (`-n`) Documentation Build

msgfmt --check FILE.po
sphinx-lint .
python -m sphinx -b html -D language=pa Doc build/html-pa
python -m sphinx -b html -n -W Doc build/html-pa

• ✅ GNU gettext (msgfmt) validation passing
• ✅ No validation errors
• ✅ GitHub Actions validation passing
• ✅ sphinx-lint — No problems found
• ✅ CPython HTML documentation build passing
• ✅ Nitpicky (-n) documentation build passing
• ✅ Repository-wide validation passing

The automated validation pipeline verifies:

• Translation syntax
• GNU gettext compatibility
• reStructuredText markup preservation
• Sphinx documentation structure
• Documentation build success
• Broken references through nitpicky builds

Automated validation does not replace human translation review.

• ✅ Punjabi (pa) officially listed in the Python Developer Guide Translation Coordinators (PR #1843 merged)
• ✅ Repository renamed to python-docs-pa
• ✅ Language tag standardized to pa
• ✅ Migration to the 3.15 translation branch
• ✅ Translation workflow established
• ✅ Daily Transifex synchronization operational
• ✅ Repository-wide msgfmt validation passing
• ✅ Repository-wide sphinx-lint validation passing
• ✅ CPython HTML documentation builds passing
• ✅ Nitpicky documentation builds passing
• ✅ Translation team expanded to 3 coordinators
• ✅ Local validation workflow documented
• ✅ Translation infrastructure established

The project includes documentation, automation, and validation resources to ensure consistent, high-quality translations.

The Punjabi (pa) translation is maintained through the official Python Documentation project on Transifex.

Translations are contributed collaboratively through the official Python Documentation Transifex project and synchronized to this repository using automated GitHub Actions workflows.

All translations are expected to follow the project's glossary, style guide, and validation workflow before being considered ready for publication.

Current priorities:

1. Continue community review and terminology consistency checks through Transifex.
2. Expand translation coverage across additional Library, HOWTO, FAQ, Reference, C API, and What's New documentation.
3. Continue growing the Punjabi translation community and onboarding new contributors.
4. Maintain glossary and style guide consistency across all translations.
5. Prepare the project for future publication through Python's documentation infrastructure.

This project supports the Python Documentation Translation initiative by making the official Python documentation accessible to Punjabi speakers while maintaining the same quality standards as the upstream project.

The primary goals are to:

• Translate the official Python documentation into Punjabi (Gurmukhi).
• Maintain consistent terminology through a shared glossary.
• Follow the Python documentation translation guidelines and style conventions.
• Ensure translation quality through automated validation, documentation builds, and collaborative review.
• Preserve reStructuredText and Sphinx markup accurately.
• Encourage community contributions and peer review.
• Keep translations synchronized with the upstream Python documentation.

python-docs-pa/
├── .github/              # GitHub Actions workflows
├── tutorial/             # Tutorial documentation
├── using/                # Using Python documentation
├── library/              # Standard library reference
├── howto/                # HOWTO guides
├── faq/                  # Frequently asked questions
├── reference/            # Language reference
├── c-api/                # Python/C API documentation
├── extending/            # Extending and embedding Python
├── installing/           # Installation documentation
├── distributing/         # Distribution guides
├── deprecations/         # Deprecated features
├── whatsnew/             # What's New documentation
│
├── README.md
├── CONTRIBUTING.md
├── STYLE_GUIDE.md
├── GLOSSARY.md
├── PROJECT_REPORT.md
│
├── *.po                  # Root translation files
└── .gitignore

The project follows the standard Python Documentation Translation workflow.

Translate in Transifex
          ↓
Follow GLOSSARY.md
          ↓
Follow STYLE_GUIDE.md
          ↓
Peer Review
          ↓
Automated synchronization to GitHub
          ↓
GitHub Actions validation
          ↓
GNU gettext validation (`msgfmt`)
          ↓
sphinx-lint
          ↓
CPython HTML Build
          ↓
Nitpicky (`-n`) Build

1. Translate or review .po files in Transifex.
2. Follow the terminology defined in GLOSSARY.md.
3. Follow the conventions described in STYLE_GUIDE.md.
4. Preserve all reStructuredText roles, directives, code blocks, and markup.
5. Validate translations locally when possible.
6. Ensure GitHub Actions complete successfully after synchronization.

The following resources are used throughout this project:

• Python Developer Guide – Documentation Translations
  https://devguide.python.org/documentation/translations/

• Python Documentation
  https://docs.python.org/

• Python Documentation on Transifex
  https://app.transifex.com/python-doc/python-newest/

• Python Documentation Style Guide
  https://devguide.python.org/documentation/style-guide/

• reStructuredText Primer (Sphinx)
  https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html

This project follows the official Python Documentation Translation initiative.

Special thanks to the Python Documentation community, translation coordinators, reviewers, and contributors whose guidance and infrastructure make community-driven documentation translations possible.

This repository follows the licensing model of the official Python Documentation Translation project.

Documentation translations are contributed under the CC0 1.0 Universal license. See the Python Documentation Translation project for additional licensing information.