Update project documentation for pa language tag and repository restructure

Author: BHUVANSH855

CONTRIBUTING.md

@@ -1,30 +1,41 @@
 # Contributing to Python Docs Punjabi (pa)
 
-Thank you for contributing to the Punjabi (India) translation of Python documentation.
+Thank you for contributing to the Punjabi (Gurmukhi) translation of the 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.
 
 ## Current Project Status
 
 ### Completed
 
-✅ Complete Tutorial documentation translated and validated (16 files)
+✅ Complete Tutorial documentation translated and validated (17 files)
 
 ✅ `bugs.po` fully translated and validated
 
+✅ `glossary.po` fully translated and validated
+
 ✅ `library/functions.po` fully translated and validated
 
 ✅ `library/stdtypes.po` fully translated and validated
 
-✅ More than 3,500 documentation messages translated
+✅ `library/functools.po` fully translated and validated
+
+✅ `library/exceptions.po` fully translated and validated
+
+✅ Language tag standardized to `pa`
+
+✅ All completed translations uploaded to Transifex
+
+✅ 4,155 documentation messages translated
 
 ### Current Focus
 
 Current priorities:
 
-* Transifex synchronization workflow
+* Automated Transifex synchronization
 * Python documentation translation coordination
-* Devguide translation listing
+* Python Devguide translation listing
+* Repository structure verification
 * Reference documentation
 * Using Python documentation
 * What's New documentation
@@ -35,6 +46,7 @@ Current priorities:
 python-docs-pa/
 ├── .gitignore
 ├── bugs.po
+├── glossary.po
 ├── CONTRIBUTING.md
 ├── GLOSSARY.md
 ├── PROJECT_REPORT.md
@@ -43,7 +55,8 @@ python-docs-pa/
 │
 ├── .github/
 │   └── workflows/
-│       └── validate.yml
+│       ├── validate.yml
+│       └── transifex-pull.yml
 │
 ├── tutorial/
 │   ├── appendix.po
@@ -53,6 +66,7 @@ python-docs-pa/
 │   ├── datastructures.po
 │   ├── errors.po
 │   ├── floatingpoint.po
+│   ├── index.po
 │   ├── inputoutput.po
 │   ├── interactive.po
 │   ├── interpreter.po
@@ -64,7 +78,9 @@ python-docs-pa/
 │   └── whatnow.po
 │
 ├── library/
+│   ├── exceptions.po
 │   ├── functions.po
+│   ├── functools.po
 │   └── stdtypes.po
 │
 ├── reference/
@@ -74,7 +90,7 @@ python-docs-pa/
 
 ## Workflow
 
-1. Fork the repository.
+1. Fork the repository (external contributors).
 2. Create a feature branch.
 3. Select an untranslated `.po` file.
 4. Translate or review entries.
@@ -248,7 +264,7 @@ Contributors should:
 * Maintain terminology consistency.
 * Keep formatting identical to the source.
 * Preserve all Sphinx and reStructuredText markup.
-* Follow existing translation patterns established in completed project files (`bugs.po`, `tutorial/`, `library/functions.po`, and `library/stdtypes.po`).
+* Follow existing translation patterns established in completed project files (`bugs.po`, `glossary.po`, `tutorial/`, `library/functions.po`, `library/stdtypes.po`, `library/functools.po`, and `library/exceptions.po`).
 
 ## Getting Help
 
@@ -261,4 +277,4 @@ For translation discussions, suggestions, and coordination, use GitHub Issues an
 
 ## License
 
-Documentation translations are contributed under the same licensing framework used by the Python Documentation Translation Project.
+Documentation translations are contributed under the CC0 license, consistent with Python Documentation Translation project guidelines.

GLOSSARY.md

@@ -1,6 +1,6 @@
 # Punjabi (pa) Python Docs Glossary
 
-This glossary defines preferred Punjabi translations for Python documentation terminology used throughout the Punjabi (India) translation project.
+This glossary defines preferred Punjabi translations for Python documentation terminology used throughout the Punjabi (Gurmukhi) translation project.
 
 Contributors should use these translations consistently across all documentation files.
 
@@ -301,25 +301,35 @@ case
 
 ---
 
+# Language Tag
+
+The project uses the IETF language tag:
+
+```text
+pa
+
 # Consistency Rules
 
 * Use glossary-approved terminology everywhere.
 * Do not invent alternative translations for existing terms.
-* Reuse terminology from completed files (`bugs.po`, `tutorial/`, `library/functions.po`, `library/stdtypes.po`).
+* Reuse terminology from completed files (`bugs.po`, `glossary.po`, `tutorial/`, `library/functions.po`, `library/stdtypes.po`, `library/functools.po`, and `library/exceptions.po`).
 * Function names, module names, class names, exception names, and code identifiers must remain unchanged.
 * When uncertain, prefer the translation already used in previously completed files.
 
 ---
 
 # Current Verified Translation Milestones
 
-| File                 | Messages |
-| -------------------- | -------: |
-| Tutorial (16 files)  |    1,416 |
-| bugs.po              |       31 |
-| library/functions.po |      535 |
-| library/stdtypes.po  |    1,592 |
-| Total Verified       |    3,574 |
+| File | Messages |
+|------|---------:|
+| Tutorial (17 files) | 1,436 |
+| bugs.po | 31 |
+| glossary.po | 30 |
+| library/functions.po | 535 |
+| library/stdtypes.po | 1,592 |
+| library/functools.po | 324 |
+| library/exceptions.po | 207 |
+| Total Verified | 4,155 |
 
 This glossary should be updated whenever a new major translation milestone introduces terminology that becomes part of the project's standard vocabulary.
 

PROJECT_REPORT.md

@@ -3,8 +3,8 @@
 **Project:** python-docs-pa
 **Coordinator:** Bhuvansh Kataria (@BHUVANSH855)
 **Repository:** https://github.com/BHUVANSH855/python-docs-pa
-**Report Date:** June 17, 2026
-**Current Status:** All Repository Translation Files Complete and Validated
+**Report Date:** June 22, 2026
+**Current Status:** All currently tracked translation files completed, validated, and uploaded to Transifex
 
 ---
 
@@ -28,6 +28,9 @@ Completed:
 * GLOSSARY.md
 * GitHub Actions validation workflow
 * Repository restructuring to match Python translation recommendations
+* Transifex synchronization workflow
+* Language tag standardized to `pa`
+* Repository renamed to `python-docs-pa`
 
 ---
 
@@ -36,13 +39,15 @@ Completed:
 ### Python Documentation Translation Community
 
 * Introduced project in Python Documentation Translation Discord
-* Received feedback from Stanislav Dzoba (Stan)
+* Received guidance and feedback from Stanislav Dzoba (Stan) and other Python documentation translation contributors
 * Dedicated Punjabi translation channel created
 * Added as Punjabi translation coordinator on Transifex
 
 ### Transifex
 
-Language Team: Punjabi
+Language Team: Punjabi (pa)
+Translation Platform: Transifex
+Language Tag: pa
 
 Coordinator:
 
@@ -58,53 +63,57 @@ https://app.transifex.com/python-doc/python-newest/
 
 ## Tutorial Documentation
 
-| File              | Messages |
-| ----------------- | -------: |
-| appendix.po       |       28 |
-| appetite.po       |       17 |
-| classes.po        |      154 |
-| controlflow.po    |      226 |
-| datastructures.po |      139 |
-| errors.po         |       96 |
-| floatingpoint.po  |       76 |
-| inputoutput.po    |      112 |
-| interactive.po    |        7 |
-| interpreter.po    |       33 |
-| introduction.po   |      120 |
-| modules.po        |      116 |
-| stdlib.po         |       67 |
-| stdlib2.po        |       65 |
-| venv.po           |       42 |
-| whatnow.po        |       18 |
+| File              | Status        | Messages |
+| ----------------- | ------------- | -------: |
+| appendix.po       | 100% Complete |       28 |
+| appetite.po       | 100% Complete |       17 |
+| classes.po        | 100% Complete |      154 |
+| controlflow.po    | 100% Complete |      226 |
+| datastructures.po | 100% Complete |      139 |
+| errors.po         | 100% Complete |       96 |
+| floatingpoint.po  | 100% Complete |       76 |
+| index.po          | 100% Complete |       20 |
+| inputoutput.po    | 100% Complete |      112 |
+| interactive.po    | 100% Complete |        7 |
+| interpreter.po    | 100% Complete |       33 |
+| introduction.po   | 100% Complete |      120 |
+| modules.po        | 100% Complete |      116 |
+| stdlib.po         | 100% Complete |       67 |
+| stdlib2.po        | 100% Complete |       65 |
+| venv.po           | 100% Complete |       42 |
+| whatnow.po        | 100% Complete |       18 |
 
 Tutorial Total:
 
 ```text
-1416 messages
-16 files
+1436 messages
+17 files
 ```
 
 ## Root Translation Files
 
-| File    | Messages |
-| ------- | -------: |
-| bugs.po |       31 |
+| File | Messages |
+|------|---------:|
+| bugs.po | 31 |
+| glossary.po | 30 |
 
 ## Library Translation Files
 
-| File         | Messages |
-| ------------ | -------: |
-| functions.po |      535 |
-| stdtypes.po  |     1592 |
+| File | Messages |
+|------|---------:|
+| functions.po | 535 |
+| stdtypes.po | 1592 |
+| functools.po | 324 |
+| exceptions.po | 207 |
 
 ## Overall Statistics
 
 ```text
-Tutorial Messages : 1416
-Root Messages     : 31
-Library Messages  : 2127
+Tutorial Messages : 1436
+Root Messages     : 61
+Library Messages  : 2658
 ────────────────────────
-Total Messages    : 3574
+Total Messages    : 4155
 ```
 
 Validation Status:
@@ -122,12 +131,15 @@ Validation Status:
 Important translation commits:
 
 ```text
-416a7b5 Translate tutorial/classes.po to Punjabi
-e8e7b4a Add Punjabi translation for tutorial stdlib section
-02f4b0c Translate tutorial/stdlib2.po to Punjabi (100%)
 60b7420 Add Punjabi translation for library/functions.po
 6592723 Translate library/stdtypes.po to Punjabi
 a389206 Add Punjabi translations for tutorial documentation
+f9debcc Translate tutorial/index.po to Punjabi
+6f06b8e Add Punjabi translation for functools module
+a894748 Translate glossary.po to Punjabi
+344ee62 Translate library/exceptions.po
+87f8012 Use pa language code across repository
+1c25498 Rename repository references to python-docs-pa
 ```
 
 ---
@@ -162,6 +174,7 @@ Validation commands:
 
 ```bash
 msgfmt --check bugs.po
+msgfmt --check glossary.po
 msgfmt --check tutorial/FILENAME.po
 msgfmt --check library/FILENAME.po
 ```
@@ -251,13 +264,13 @@ PASS
 Translation Status:
 
 ```text
-All tracked translation files complete
+All currently tracked translation files complete and validated
 ```
 
 Messages Translated:
 
 ```text
-3574
+4155
 ```
 
 ---
@@ -266,7 +279,7 @@ Messages Translated:
 
 ## Coordination
 
-* Finalize Transifex synchronization workflow
+* Automate Transifex synchronization workflow
 * Coordinate with Python Documentation Translation Team
 * Prepare Python Devguide translation listing PR
 
@@ -296,6 +309,6 @@ This project aims to lower barriers for Punjabi-speaking learners and contribute
 
 # Report Version
 
-Version: 2.0
+Version: 2.1
 
-Generated after completion and validation of all currently tracked translation files in the repository, including Tutorial documentation, bugs.po, library/functions.po, and library/stdtypes.po.
+Generated after completion and validation of all currently tracked translation files in the repository, including Tutorial documentation, bugs.po, glossary.po, library/functions.po, library/stdtypes.po, library/functools.po, and library/exceptions.po. All completed translations have also been uploaded to the Python Documentation Transifex project.