Update documentation

Author: BHUVANSH855

CONTRIBUTING.md

@@ -1,6 +1,37 @@
 # Contributing to Python Docs Punjabi (pa-IN)
 
-Thank you for contributing to the Punjabi translation of Python documentation.
+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.
+
+## Current Project Status
+
+### Completed
+
+✅ 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
+
+### Current Focus
+
+The project is preparing for expansion into:
+
+* library/
+* reference/
+* using/
+* whatsnew/
 
 ## Repository Structure
 
@@ -10,7 +41,21 @@ python-docs-pa-in/
 ├── 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/
@@ -21,10 +66,12 @@ python-docs-pa-in/
 
 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.
+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.
 
 ## Creating a New Translation File
 
@@ -34,84 +81,174 @@ 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
+  --output-file=PATH_TO_OUTPUT.po
 ```
 
 Example:
 
 ```bash
 msginit \
   --locale=pa_IN \
-  --input=stdlib.pot \
-  --output-file=tutorial/stdlib.po
+  --input=library/functions.pot \
+  --output-file=library/functions.po
 ```
 
 ## Validation
 
-Run:
+### Check for syntax errors
 
 ```bash
-msgfmt --check tutorial/FILENAME.po
+msgfmt --check FILE.po
 ```
 
-Check translation statistics:
+### View translation statistics
 
 ```bash
-msgfmt --statistics tutorial/FILENAME.po
+msgfmt --statistics FILE.po
 ```
 
-View untranslated entries:
+### Show untranslated entries
 
 ```bash
-msgattrib --untranslated tutorial/FILENAME.po
+msgattrib --untranslated FILE.po
+```
+
+### Show translated entries
+
+```bash
+msgattrib --translated FILE.po
 ```
 
 ## Translation Rules
 
-### Do Not Translate
+### Never Translate
+
+#### Python Keywords
+
+```text
+if
+else
+elif
+for
+while
+class
+def
+return
+import
+from
+try
+except
+finally
+raise
+pass
+with
+yield
+lambda
+```
+
+#### Python Identifiers
+
+* Function names
+* Class names
+* Module names
+* Exception names
+* Variable names
+
+Examples:
+
+```text
+print
+len
+range
+ValueError
+TypeError
+list
+dict
+tuple
+set
+os
+sys
+json
+```
+
+#### Documentation Markup
+
+```rst
+:func:
+:class:
+:mod:
+:meth:
+:attr:
+:exc:
+:term:
+:ref:
+```
+
+#### Other Items
 
-* 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
+* Code syntax
+* File names
+* Package names
+* Python version numbers
 
 ### Translate
 
-* Headings
+* Titles and headings
 * Explanatory text
 * Notes and warnings
-* Comments inside code examples
+* Comments inside examples
 * User-facing descriptions
+* Table content
+* Documentation narratives
 
 ## Quality Checklist
 
-Before submitting:
+Before submitting a Pull Request:
 
-* [ ] All translations completed
-* [ ] `msgfmt --check` passes
+* [ ] All intended entries translated
+* [ ] msgfmt validation passes
 * [ ] No broken RST markup
-* [ ] Terminology follows `GLOSSARY.md`
-* [ ] Style follows `STYLE_GUIDE.md`
-* [ ] GitHub Actions passes
+* [ ] No modified code examples
+* [ ] Terminology follows GLOSSARY.md
+* [ ] Style follows STYLE_GUIDE.md
+* [ ] Translation reviewed for natural Punjabi wording
+* [ ] GitHub Actions validation passes
 
 ## Commit Message Examples
 
 ```text
-Translate tutorial/classes.po to Punjabi (pa)
+Translate library/functions.po to Punjabi
+
+Translate reference/datamodel.po to Punjabi
 
-Translate tutorial/stdlib.po to Punjabi (pa)
+Update glossary terminology
 
-Update glossary and translation guidelines
+Improve translation consistency
+
+Fix validation issues in library modules
 ```
 
+## Translation Standards
+
+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.
+
 ## Getting Help
 
-Before translating technical terms, check:
+Before introducing new terminology, review:
+
+* GLOSSARY.md
+* STYLE_GUIDE.md
+
+For translation discussions, suggestions, and coordination, use GitHub Issues and Pull Requests.
 
-* `GLOSSARY.md`
-* `STYLE_GUIDE.md`
+## License
 
-For project discussions and coordination, use GitHub Issues or the Python documentation translation community channels.
+Documentation translations are contributed under the same licensing framework used by the Python Documentation Translation Project.