Skip to content

Commit 1f449c1

Browse files
committed
Update README with latest translation progress
1 parent a389206 commit 1f449c1

1 file changed

Lines changed: 78 additions & 57 deletions

File tree

‎README.md‎

Lines changed: 78 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -6,40 +6,55 @@ This project aims to translate Python's official documentation into Punjabi (Gur
66

77
## Status
88

9-
🎉 Python Tutorial Translation Complete
9+
🎉 All currently tracked translation files are complete and validated.
1010

11-
🎉 Core Library Reference Translation Milestone Reached
11+
The repository currently contains fully translated and validated files across:
1212

13-
The complete Python Tutorial section has been translated into Punjabi (Gurmukhi), validated using GNU gettext tools, and tagged as a project milestone.
13+
* Tutorial Documentation
14+
* Core Library Reference
15+
* bugs.po
1416

15-
Additionally, two major Library Reference files have been fully translated and validated:
17+
All translation files pass GNU gettext validation checks and are tracked in GitHub.
1618

19+
Completed major translation milestones:
20+
21+
* `bugs.po`
1722
* `library/functions.po`
1823
* `library/stdtypes.po`
24+
* Complete Tutorial Documentation Set
1925

20-
Together they represent more than 2,100 translated Library Reference messages.
21-
22-
**Latest tutorial milestone:** `tutorial-complete`
26+
**Latest milestone:** All current repository translation files completed and validated
2327

24-
**Latest library milestone:** `library/stdtypes.po` completed
28+
**Latest milestone:** All current `.po` files translated and validated
2529

2630
## Current Progress
2731

2832
### Completed Tutorial Files
2933

30-
| File | Status | Messages |
31-
| ----------------- | ---------- | -------: |
32-
| appetite.po | ✅ Complete | 17 |
33-
| interpreter.po | ✅ Complete | 33 |
34-
| introduction.po | ✅ Complete | 120 |
35-
| controlflow.po | ✅ Complete | 226 |
36-
| datastructures.po | ✅ Complete | 139 |
37-
| inputoutput.po | ✅ Complete | 112 |
38-
| modules.po | ✅ Complete | 116 |
39-
| errors.po | ✅ Complete | 96 |
40-
| classes.po | ✅ Complete | 154 |
41-
| stdlib.po | ✅ Complete | 67 |
42-
| stdlib2.po | ✅ Complete | 65 |
34+
| File | Status | Messages |
35+
|--------|--------|---------:|
36+
| appendix.po | ✅ Complete | 28 |
37+
| appetite.po | ✅ Complete | 17 |
38+
| classes.po | ✅ Complete | 154 |
39+
| controlflow.po | ✅ Complete | 226 |
40+
| datastructures.po | ✅ Complete | 139 |
41+
| errors.po | ✅ Complete | 96 |
42+
| floatingpoint.po | ✅ Complete | 76 |
43+
| inputoutput.po | ✅ Complete | 112 |
44+
| interactive.po | ✅ Complete | 7 |
45+
| interpreter.po | ✅ Complete | 33 |
46+
| introduction.po | ✅ Complete | 120 |
47+
| modules.po | ✅ Complete | 116 |
48+
| stdlib.po | ✅ Complete | 67 |
49+
| stdlib2.po | ✅ Complete | 65 |
50+
| venv.po | ✅ Complete | 42 |
51+
| whatnow.po | ✅ Complete | 18 |
52+
53+
### Completed Root Files
54+
55+
| File | Status | Messages |
56+
|--------|--------|---------:|
57+
| bugs.po | ✅ Complete | 31 |
4358

4459
### Completed Library Files
4560

@@ -50,46 +65,51 @@ Together they represent more than 2,100 translated Library Reference messages.
5065

5166
### Project Statistics
5267

53-
| Metric | Value |
54-
| ---------------------------- | ----: |
55-
| Tutorial Files Completed | 11 |
56-
| Tutorial Messages Translated | 1,145 |
57-
| Library Files Completed | 2 |
58-
| Library Messages Translated | 2,127 |
59-
| Total Messages Translated | 3,272 |
68+
| Metric | Value |
69+
|----------|------:|
70+
| Tutorial Files Completed | 16 |
71+
| Tutorial Messages Translated | 1,416 |
72+
| Root Files Completed | 1 |
73+
| Root Messages Translated | 31 |
74+
| Library Files Completed | 2 |
75+
| Library Messages Translated | 2,127 |
76+
| Total Messages Translated | 3,574 |
6077

6178
## Validation Status
6279

6380
All completed translation files successfully pass validation.
6481

6582
```bash
83+
msgfmt --check bugs.po
6684
msgfmt --check tutorial/FILENAME.po
6785
msgfmt --check library/FILENAME.po
6886
```
6987

7088
Validation summary:
7189

7290
* ✅ No validation errors
73-
* ✅ No untranslated messages in completed files
74-
* ✅ Tutorial translation complete
75-
* ✅ `library/functions.po` fully translated
76-
* ✅ `library/stdtypes.po` fully translated
91+
* ✅ No untranslated messages
92+
* ✅ No fuzzy messages
93+
* ✅ Tutorial files validated
94+
* ✅ Library files validated
95+
* ✅ bugs.po validated
7796
* ✅ Repository-wide validation passing
7897
* ✅ GitHub Actions validation passing
7998

8099
## Recent Milestones
81100

82-
* ✅ Completed `tutorial/classes.po`
83-
* ✅ Completed `tutorial/stdlib.po`
84-
* ✅ Completed `tutorial/stdlib2.po`
85-
* ✅ Finished full Python Tutorial translation
86-
* ✅ Created `tutorial-complete` release tag
87-
* ✅ Completed `library/functions.po` (535 messages)
88-
* ✅ Completed `library/stdtypes.po` (1592 messages)
89-
* ✅ Surpassed 3,000 translated documentation messages
90-
* ✅ Validated completed files using GNU gettext tools
91-
* ✅ Pushed translation milestones to GitHub
92-
* ✅ Repository synchronized with updated Python documentation structure
101+
* ✅ Completed `tutorial/appendix.po`
102+
* ✅ Completed `tutorial/floatingpoint.po`
103+
* ✅ Completed `tutorial/interactive.po`
104+
* ✅ Completed `tutorial/venv.po`
105+
* ✅ Completed `tutorial/whatnow.po`
106+
* ✅ Completed `bugs.po`
107+
* ✅ Completed `library/functions.po`
108+
* ✅ Completed `library/stdtypes.po`
109+
* ✅ Completed all current translation files in repository
110+
* ✅ Exceeded 3,500 translated messages
111+
* ✅ Repository-wide validation passing
112+
* ✅ All translations committed and pushed to GitHub
93113

94114
## Infrastructure
95115

@@ -102,20 +122,16 @@ Validation summary:
102122

103123
## Next Phase
104124

105-
Current focus areas:
106-
107-
### Library Reference
108-
109-
* Additional files in `library/`
110-
111-
### Future Areas
125+
Current priorities:
112126

113-
* Language Reference
114-
* HOWTO Guides
115-
* FAQ
116-
* Using Python Documentation
117-
* What's New Documentation
118-
* Glossary refinement and terminology review
127+
1. Finalize Transifex synchronization workflow
128+
2. Confirm language identifier (`pa` vs `pa-IN`)
129+
3. Coordinate with Python Documentation Translation Team
130+
4. Open devguide translation listing PR
131+
5. Expand translation coverage into:
132+
* Reference Documentation
133+
* Using Python Documentation
134+
* What's New Documentation
119135

120136
## Goals
121137

@@ -143,17 +159,22 @@ python-docs-pa-in/
143159
│ └── validate.yml
144160
│
145161
├── tutorial/
162+
│ ├── appendix.po
146163
│ ├── appetite.po
147164
│ ├── classes.po
148165
│ ├── controlflow.po
149166
│ ├── datastructures.po
150167
│ ├── errors.po
168+
│ ├── floatingpoint.po
151169
│ ├── inputoutput.po
170+
│ ├── interactive.po
152171
│ ├── interpreter.po
153172
│ ├── introduction.po
154173
│ ├── modules.po
155174
│ ├── stdlib.po
156-
│ └── stdlib2.po
175+
│ ├── stdlib2.po
176+
│ ├── venv.po
177+
│ └── whatnow.po
157178
│
158179
├── library/
159180
│ ├── functions.po

0 commit comments

Comments
 (0)