Skip to content

Commit dc5a7fe

Browse files
BHUVANSH855BHUVANSH855
committed
update documentation
1 parent 6592723 commit dc5a7fe

3 files changed

Lines changed: 714 additions & 219 deletions

File tree

‎GLOSSARY.md‎

Lines changed: 262 additions & 65 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,175 @@
11
# Punjabi (pa-IN) Python Docs Glossary
22

3-
This glossary defines preferred Punjabi translations for commonly used Python documentation terminology.
4-
5-
Contributors should use these translations consistently throughout the project.
6-
7-
| English | Punjabi |
8-
| ----------- | ---------- |
9-
| function | ਫੰਕਸ਼ਨ |
10-
| method | ਵਿਧੀ |
11-
| class | ਕਲਾਸ |
12-
| instance | ਇੰਸਟੈਂਸ |
13-
| object | ਵਸਤੂ |
14-
| attribute | ਐਟ੍ਰਿਬਿਊਟ |
15-
| variable | ਵੇਰੀਏਬਲ |
16-
| parameter | ਪੈਰਾਮੀਟਰ |
17-
| argument | ਆਰਗੂਮੈਂਟ |
18-
| statement | ਕਥਨ |
19-
| expression | ਸਮੀਕਰਨ |
20-
| namespace | ਨੇਮਸਪੇਸ |
21-
| scope | ਸਕੋਪ |
22-
| inheritance | ਵਿਰਾਸਤ |
23-
| iterator | ਇਟਰੇਟਰ |
24-
| generator | ਜਨਰੇਟਰ |
25-
| list | ਸੂਚੀ |
26-
| dictionary | ਡਿਕਸ਼ਨਰੀ |
27-
| tuple | ਟਪਲ |
28-
| set | ਸੈੱਟ |
29-
| string | ਸਤਰ |
30-
| integer | ਪੂਰਨ ਅੰਕ |
31-
| float | ਫਲੋਟ |
32-
| boolean | ਬੁਲੀਅਨ |
33-
| mutable | ਪਰਿਵਰਤਨਯੋਗ |
34-
| immutable | ਅਪਰਿਵਰਤਨੀਯ |
35-
| exception | ਅਪਵਾਦ |
36-
| error | ਗਲਤੀ |
37-
| module | ਮੌਡਿਊਲ |
38-
| package | ਪੈਕੇਜ |
39-
| interpreter | ਦੁਭਾਸ਼ੀਆ |
40-
| loop | ਲੂਪ |
41-
| input | ਇਨਪੁੱਟ |
42-
| output | ਆਉਟਪੁੱਟ |
43-
44-
## Standard Library Terms
3+
This glossary defines preferred Punjabi translations for Python documentation terminology used throughout the Punjabi (India) translation project.
4+
5+
Contributors should use these translations consistently across all documentation files.
6+
7+
---
8+
9+
# Core Python Terms
10+
11+
| English | Punjabi |
12+
| --------------------------- | -------------------------- |
13+
| function | ਫੰਕਸ਼ਨ |
14+
| built-in function | ਬਿਲਟ-ਇਨ ਫੰਕਸ਼ਨ |
15+
| method | ਵਿਧੀ |
16+
| class | ਕਲਾਸ |
17+
| object | ਵਸਤੂ |
18+
| instance | ਇੰਸਟੈਂਸ |
19+
| attribute | ਐਟ੍ਰਿਬਿਊਟ |
20+
| variable | ਵੇਰੀਏਬਲ |
21+
| parameter | ਪੈਰਾਮੀਟਰ |
22+
| argument | ਆਰਗੂਮੈਂਟ |
23+
| statement | ਕਥਨ |
24+
| expression | ਅਭਿਵ੍ਯੰਜਨਾ |
25+
| namespace | ਨੇਮਸਪੇਸ |
26+
| scope | ਸਕੋਪ |
27+
| inheritance | ਵਿਰਾਸਤ |
28+
| multiple inheritance | ਬਹੁ-ਵਿਰਾਸਤ |
29+
| iterator | ਇਟਰੇਟਰ |
30+
| iteration | ਇਟਰੇਸ਼ਨ |
31+
| generator | ਜਨਰੇਟਰ |
32+
| container | ਕੰਟੇਨਰ |
33+
| protocol | ਪ੍ਰੋਟੋਕੋਲ |
34+
| iterator protocol | ਇਟਰੇਟਰ ਪ੍ਰੋਟੋਕੋਲ |
35+
| context manager | ਕਾਨਟੈਕਸਟ ਮੈਨੇਜਰ |
36+
| context management | ਕਾਨਟੈਕਸਟ ਪ੍ਰਬੰਧਨ |
37+
| context management protocol | ਕਾਨਟੈਕਸਟ ਪ੍ਰਬੰਧਨ ਪ੍ਰੋਟੋਕੋਲ |
38+
39+
---
40+
41+
# Data Types
42+
43+
| English | Punjabi |
44+
| ------------------ | ---------------- |
45+
| type | ਕਿਸਮ |
46+
| numeric | ਸੰਖਿਆਤਮਕ |
47+
| integer | ਪੂਰਨ ਅੰਕ |
48+
| floating-point | ਫਲੋਟਿੰਗ-ਪੌਇੰਟ |
49+
| complex number | ਕੰਪਲੈਕਸ ਨੰਬਰ |
50+
| boolean | ਬੁਲੀਅਨ |
51+
| string | ਸਤਰ |
52+
| text sequence | ਪਾਠ ਕ੍ਰਮ |
53+
| list | ਸੂਚੀ |
54+
| tuple | ਟਪਲ |
55+
| set | ਸੈੱਟ |
56+
| dictionary | ਡਿਕਸ਼ਨਰੀ |
57+
| mapping | ਮੈਪਿੰਗ |
58+
| range | ਰੇਂਜ |
59+
| bytes | ਬਾਈਟਸ |
60+
| bytearray | ਬਾਈਟਐਰੇ |
61+
| memoryview | ਮੈਮੋਰੀਵਿਊ |
62+
| array | ਐਰੇ |
63+
| sequence | ਕ੍ਰਮ |
64+
| mutable sequence | ਪਰਿਵਰਤਨਯੋਗ ਕ੍ਰਮ |
65+
| immutable sequence | ਅਪਰਿਵਰਤਨਯੋਗ ਕ੍ਰਮ |
66+
67+
---
68+
69+
# Mutability
70+
71+
| English | Punjabi |
72+
| --------- | ----------- |
73+
| mutable | ਪਰਿਵਰਤਨਯੋਗ |
74+
| immutable | ਅਪਰਿਵਰਤਨਯੋਗ |
75+
| hash | ਹੈਸ਼ |
76+
| hashing | ਹੈਸ਼ਿੰਗ |
77+
78+
---
79+
80+
# Operators and Operations
81+
82+
| English | Punjabi |
83+
| --------------- | ------------- |
84+
| operation | ਕਾਰਵਾਈ |
85+
| arithmetic | ਅੰਕਗਣਿਤ |
86+
| comparison | ਤੁਲਨਾ |
87+
| concatenation | ਜੋੜ |
88+
| repetition | ਦੁਹਰਾਵਾ |
89+
| assignment | ਅਸਾਈਨਮੈਂਟ |
90+
| subscript | ਸਬਸਕ੍ਰਿਪਟ |
91+
| slice | ਸਲਾਈਸ |
92+
| bitwise | ਬਿੱਟਵਾਈਜ਼ |
93+
| masking | ਮਾਸਕਿੰਗ |
94+
| shifting | ਸ਼ਿਫਟਿੰਗ |
95+
| unary operator | ਯੂਨਰੀ ਓਪਰੇਟਰ |
96+
| binary operator | ਬਾਈਨਰੀ ਓਪਰੇਟਰ |
97+
98+
---
99+
100+
# Collections and Iteration
101+
102+
| English | Punjabi |
103+
| ------------------- | --------------- |
104+
| iterable | ਇਟਰੇਬਲ |
105+
| iterator | ਇਟਰੇਟਰ |
106+
| loop | ਲੂਪ |
107+
| iteration | ਇਟਰੇਸ਼ਨ |
108+
| membership test | ਮੈਂਬਰਸ਼ਿਪ ਜਾਂਚ |
109+
| sequence operations | ਕ੍ਰਮ ਕਾਰਵਾਈਆਂ |
110+
| mapping operations | ਮੈਪਿੰਗ ਕਾਰਵਾਈਆਂ |
111+
112+
---
113+
114+
# Exceptions and Errors
115+
116+
| English | Punjabi |
117+
| ------------- | ----------- |
118+
| exception | ਅਪਵਾਦ |
119+
| error | ਗਲਤੀ |
120+
| traceback | ਟ੍ਰੇਸਬੈਕ |
121+
| warning | ਚੇਤਾਵਨੀ |
122+
| runtime error | ਰਨਟਾਈਮ ਗਲਤੀ |
123+
124+
---
125+
126+
# Modules and Libraries
127+
128+
| English | Punjabi |
129+
| ---------------- | --------------- |
130+
| module | ਮੌਡਿਊਲ |
131+
| package | ਪੈਕੇਜ |
132+
| standard library | ਮਿਆਰੀ ਲਾਇਬ੍ਰੇਰੀ |
133+
| library | ਲਾਇਬ੍ਰੇਰੀ |
134+
| import | ਇੰਪੋਰਟ |
135+
| built-in module | ਬਿਲਟ-ਇਨ ਮੌਡਿਊਲ |
136+
137+
---
138+
139+
# String and Formatting Terms
140+
141+
| English | Punjabi |
142+
| ------------------------ | --------------------- |
143+
| formatting | ਫਾਰਮੈਟਿੰਗ |
144+
| string formatting | ਸਤਰ ਫਾਰਮੈਟਿੰਗ |
145+
| interpolation | ਇੰਟਰਪੋਲੇਸ਼ਨ |
146+
| formatted string literal | ਫਾਰਮੈਟ ਕੀਤੀ ਸਤਰ ਲਿਟਰਲ |
147+
| f-string | f-string |
148+
| placeholder | ਪਲੇਸਹੋਲਡਰ |
149+
| template | ਟੈਂਪਲੇਟ |
150+
| delimiter | ਡਿਲਿਮਿਟਰ |
151+
| universal newlines | ਯੂਨੀਵਰਸਲ ਨਿਊਲਾਈਨਜ਼ |
152+
153+
---
154+
155+
# Numeric Terms
156+
157+
| English | Punjabi |
158+
| ----------- | ----------- |
159+
| decimal | ਦਸ਼ਮਲਵ |
160+
| hexadecimal | ਹੈਕਸਾਡੈਸੀਮਲ |
161+
| octal | ਆਕਟਲ |
162+
| binary | ਬਾਈਨਰੀ |
163+
| precision | ਸ਼ੁੱਧਤਾ |
164+
| rounding | ਗੋਲਾਈਕਰਨ |
165+
| conversion | ਰੂਪਾਂਤਰਨ |
166+
167+
---
168+
169+
# Standard Library Terms
45170

46171
| English | Punjabi |
47172
| ------------------ | ---------------- |
48-
| standard library | ਮਿਆਰੀ ਲਾਇਬ੍ਰੇਰੀ |
49173
| thread | ਥ੍ਰੈਡ |
50174
| threading | ਥ੍ਰੈਡਿੰਗ |
51175
| queue | ਕਤਾਰ |
@@ -54,63 +178,136 @@ Contributors should use these translations consistently throughout the project.
54178
| event | ਇਵੈਂਟ |
55179
| logging | ਲੌਗਿੰਗ |
56180
| log message | ਲੌਗ ਸੁਨੇਹਾ |
57-
| binary data | ਬਾਈਨਰੀ ਡਾਟਾ |
58-
| record | ਰਿਕਾਰਡ |
59-
| template | ਟੈਂਪਲੇਟ |
60-
| placeholder | ਪਲੇਸਹੋਲਡਰ |
61-
| delimiter | ਡਿਲਿਮਟਰ |
62181
| callback | ਕਾਲਬੈਕ |
63182
| cache | ਕੈਸ਼ |
64183
| garbage collection | ਗਾਰਬੇਜ ਕਲੇਕਸ਼ਨ |
65184
| weak reference | ਕਮਜ਼ੋਰ ਰੈਫਰੈਂਸ |
66185
| synchronization | ਸਿੰਕ੍ਰੋਨਾਈਜ਼ੇਸ਼ਨ |
67-
| precision | ਸ਼ੁੱਧਤਾ |
68-
| rounding | ਗੋਲਾਈਕਰਨ |
69-
| decimal | ਦਸ਼ਮਲਵ |
70-
| arithmetic | ਅੰਕਗਣਿਤ |
186+
| binary data | ਬਾਈਨਰੀ ਡਾਟਾ |
187+
| record | ਰਿਕਾਰਡ |
71188

72-
## Documentation Terms
189+
---
190+
191+
# Documentation Terms
73192

74193
| English | Punjabi |
75194
| ------------- | ------------------ |
76195
| tutorial | ਟਿਊਟੋਰਿਅਲ |
77196
| documentation | ਦਸਤਾਵੇਜ਼ੀਕਰਨ |
78-
| example | ਉਦਾਹਰਨ |
79-
| reference | ਸੰਦਰਭ |
80197
| guide | ਮਾਰਗਦਰਸ਼ਿਕਾ |
81-
| section | ਭਾਗ |
82-
| chapter | ਅਧਿਆਇ |
198+
| reference | ਸੰਦਰਭ |
199+
| example | ਉਦਾਹਰਨ |
83200
| explanation | ਵਿਆਖਿਆ |
201+
| chapter | ਅਧਿਆਇ |
202+
| section | ਭਾਗ |
84203
| translation | ਅਨੁਵਾਦ |
85204
| contributor | ਯੋਗਦਾਨਕਰਤਾ |
86205
| validation | ਪ੍ਰਮਾਣਿਕਤਾ ਜਾਂਚ |
87206
| terminology | ਪਰਿਭਾਸ਼ਿਕ ਸ਼ਬਦਾਵਲੀ |
207+
| glossary | ਸ਼ਬਦਾਵਲੀ |
208+
| style guide | ਸ਼ੈਲੀ ਮਾਰਗਦਰਸ਼ਿਕਾ |
88209

89-
## Terms Commonly Left Untranslated
210+
---
90211

91-
The following terms should generally remain in English unless context requires otherwise:
212+
# Documentation Workflow Terms
92213

93-
```text id="wv6lqr"
214+
| English | Punjabi |
215+
| -------------------- | ----------------- |
216+
| translated message | ਅਨੁਵਾਦਿਤ ਸੁਨੇਹਾ |
217+
| untranslated message | ਅਣਅਨੁਵਾਦਿਤ ਸੁਨੇਹਾ |
218+
| fuzzy translation | ਅਸਪਸ਼ਟ ਅਨੁਵਾਦ |
219+
| source string | ਸਰੋਤ ਸਤਰ |
220+
| target string | ਲਕਸ਼ ਸਤਰ |
221+
| validation check | ਪ੍ਰਮਾਣਿਕਤਾ ਜਾਂਚ |
222+
| milestone | ਮੀਲ ਪੱਥਰ |
223+
| release tag | ਰਿਲੀਜ਼ ਟੈਗ |
224+
225+
---
226+
227+
# Terms Commonly Left Untranslated
228+
229+
The following terms should normally remain in English:
230+
231+
```text
94232
Python
95233
API
96234
JSON
97235
XML
98236
HTML
99237
HTTP
238+
HTTPS
100239
URL
101240
Unicode
102241
UTF-8
242+
ASCII
103243
Git
104244
GitHub
105245
Transifex
106246
Linux
107247
Windows
108248
macOS
249+
POSIX
250+
CPython
251+
PyPI
252+
pip
253+
venv
254+
```
255+
256+
---
257+
258+
# Common Python Keywords
259+
260+
These should never be translated:
261+
262+
```text
263+
if
264+
else
265+
elif
266+
for
267+
while
268+
class
269+
def
270+
return
271+
import
272+
from
273+
try
274+
except
275+
finally
276+
raise
277+
pass
278+
with
279+
yield
280+
lambda
281+
and
282+
or
283+
not
284+
global
285+
nonlocal
286+
async
287+
await
288+
match
289+
case
109290
```
110291

111-
## Consistency Rules
292+
---
293+
294+
# Consistency Rules
295+
296+
* Use glossary-approved terminology everywhere.
297+
* Do not invent alternative translations for existing terms.
298+
* Reuse terminology from completed files (`tutorial/`, `functions.po`, `stdtypes.po`).
299+
* Function names, module names, class names, exception names, and code identifiers must remain unchanged.
300+
* When uncertain, prefer the translation already used in previously completed files.
301+
302+
---
303+
304+
# Current Verified Translation Milestones
305+
306+
| File | Messages |
307+
| -------------------- | -------: |
308+
| Tutorial (11 files) | 1,145 |
309+
| library/functions.po | 535 |
310+
| library/stdtypes.po | 1,592 |
311+
| Total Verified | 3,272 |
112312

113-
* Use glossary terms consistently across all files.
114-
* Prefer glossary-approved translations over newly invented variants.
115-
* When translating new documentation sections, reuse terminology from completed tutorial files.
116-
* Technical names, code identifiers, module names, class names, and function names should remain unchanged unless explicitly translated in official Python documentation guidance.
313+
This glossary should be updated whenever a new major translation milestone introduces terminology that becomes part of the project's standard vocabulary.

0 commit comments

Comments
 (0)