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

This project follows the Python Documentation Translation Guidelines and aims to provide high-quality Punjabi (Gurmukhi) translations for Python learners, educators, and developers.

✅ Entire tutorial/ section translated and validated.

Completed tutorial files:

• appetite.po
• introduction.po
• interpreter.po
• controlflow.po
• datastructures.po
• inputoutput.po
• modules.po
• errors.po
• classes.po
• stdlib.po
• stdlib2.po

The project is preparing for expansion into:

• library/
• reference/
• using/
• whatsnew/

python-docs-pa-in/
├── README.md
├── CONTRIBUTING.md
├── GLOSSARY.md
├── STYLE_GUIDE.md
├── .github/
│   └── workflows/
│       └── validate.yml
├── tutorial/
│   ├── appetite.po
│   ├── introduction.po
│   ├── interpreter.po
│   ├── controlflow.po
│   ├── datastructures.po
│   ├── inputoutput.po
│   ├── modules.po
│   ├── errors.po
│   ├── classes.po
│   ├── stdlib.po
│   └── stdlib2.po
├── library/
├── reference/
├── using/
└── whatsnew/

1. Fork the repository.
2. Create a feature branch.
3. Select an untranslated .po file.
4. Translate or review entries.
5. Validate the file.
6. Commit your changes.
7. Push to your fork.
8. Open a Pull Request.

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

msginit \
  --locale=pa_IN \
  --input=PATH_TO_TEMPLATE.pot \
  --output-file=PATH_TO_OUTPUT.po

Example:

msginit \
  --locale=pa_IN \
  --input=library/functions.pot \
  --output-file=library/functions.po

msgfmt --check FILE.po

msgfmt --statistics FILE.po

msgattrib --untranslated FILE.po

msgattrib --translated FILE.po

if
else
elif
for
while
class
def
return
import
from
try
except
finally
raise
pass
with
yield
lambda

• Function names
• Class names
• Module names
• Exception names
• Variable names

Examples:

print
len
range
ValueError
TypeError
list
dict
tuple
set
os
sys
json

:func:
:class:
:mod:
:meth:
:attr:
:exc:
:term:
:ref:

• URLs
• Code syntax
• File names
• Package names
• Python version numbers

• Titles and headings
• Explanatory text
• Notes and warnings
• Comments inside examples
• User-facing descriptions
• Table content
• Documentation narratives

Before submitting a Pull Request:

• All intended entries translated
• msgfmt validation passes
• No broken RST markup
• No modified code examples
• Terminology follows GLOSSARY.md
• Style follows STYLE_GUIDE.md
• Translation reviewed for natural Punjabi wording
• GitHub Actions validation passes

Translate library/functions.po to Punjabi

Translate reference/datamodel.po to Punjabi

Update glossary terminology

Improve translation consistency

Fix validation issues in library modules

Contributors should:

• Prefer natural Punjabi over literal word-for-word translation.
• Preserve technical accuracy.
• Maintain terminology consistency.
• Keep formatting identical to the source.
• Preserve all Sphinx and reStructuredText markup.
• Follow existing translation patterns established in the completed tutorial section.

Before introducing new terminology, review:

• GLOSSARY.md
• STYLE_GUIDE.md

For translation discussions, suggestions, and coordination, use GitHub Issues and Pull Requests.

Documentation translations are contributed under the same licensing framework used by the Python Documentation Translation Project.