GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — python-docs-pa/CONTRIBUTING.md at tutorial-complete · python/python-docs-pa

Expand file tree

/

CONTRIBUTING.md

Copy path
More file actions
More file actions

Latest commit

 

History

History
History
117 lines (84 loc) · 2.14 KB
/

CONTRIBUTING.md

Copy path

File metadata and controls

117 lines (84 loc) · 2.14 KB
Raw
Copy raw file
Download raw file
Outline
Edit and raw actions

Contributing to Python Docs Punjabi (pa-IN)

Thank you for contributing to the Punjabi translation of Python documentation.

Repository Structure

python-docs-pa-in/
├── README.md
├── CONTRIBUTING.md
├── GLOSSARY.md
├── STYLE_GUIDE.md
├── tutorial/
├── library/
├── reference/
├── using/
└── whatsnew/

Workflow

  1. Fork the repository.
  2. Create a feature branch.
  3. Translate or review .po files.
  4. Validate before committing.
  5. Commit your changes.
  6. Open a Pull Request.

Creating a New Translation File

Generate a new .po file from the latest CPython gettext template:

msginit \
  --locale=pa_IN \
  --input=PATH_TO_TEMPLATE.pot \
  --output-file=tutorial/FILENAME.po

Example:

msginit \
  --locale=pa_IN \
  --input=stdlib.pot \
  --output-file=tutorial/stdlib.po

Validation

Run:

msgfmt --check tutorial/FILENAME.po

Check translation statistics:

msgfmt --statistics tutorial/FILENAME.po

View untranslated entries:

msgattrib --untranslated tutorial/FILENAME.po

Translation Rules

Do Not Translate

  • Python keywords (if, else, for, while, class, def)
  • Function names (print, len, range)
  • Module names (os, sys, json)
  • Exception names (ValueError, TypeError)
  • URLs
  • RST roles (:func:, :class:, :mod:, :ref:)
  • Code blocks

Translate

  • Headings
  • Explanatory text
  • Notes and warnings
  • Comments inside code examples
  • User-facing descriptions

Quality Checklist

Before submitting:

  • All translations completed
  • msgfmt --check passes
  • No broken RST markup
  • Terminology follows GLOSSARY.md
  • Style follows STYLE_GUIDE.md
  • GitHub Actions passes

Commit Message Examples

Translate tutorial/classes.po to Punjabi (pa)

Translate tutorial/stdlib.po to Punjabi (pa)

Update glossary and translation guidelines

Getting Help

Before translating technical terms, check:

  • GLOSSARY.md
  • STYLE_GUIDE.md

For project discussions and coordination, use GitHub Issues or the Python documentation translation community channels.

You are visitor 01402520 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.