Decide object, module, type, list and float - #56
Merged
Conversation
L02 was reporting 86 entries whose Vietnamese is the English handed back, and 77 of them were the single words module and object sitting in an index category next to the thing they categorise. The glossary had no row for either, and its rows for type, list and float said keep the English, which is why G03 was reporting 71 correct translations of them. Measured over the 548 catalogs of the pinned mirror, counting prose the glossary matcher finds the term in and masking markup on the Vietnamese side so an identifier inside a role does not read as the English word: object doi tuong 63 object 46 type kieu 30 type 16 list danh sach 34 list 15 float so thuc 4 float 4 module mo-dun 17 module 64 object, type, list and float take the Vietnamese the corpus already uses. type, list and float also take identifier, because each names a thing in a table somewhere and the row now says both. module has no majority and does not get one by area, so it is decided on the reason instead. mo-dun is module spelled with a hyphen and carries nothing a reader does not already get from module, where doi tuong, kieu, danh sach and so thuc are Vietnamese words that mean something. bytecode, docstring, iterable, lambda, traceback and REPL are already kept for that reason and module belongs with them. import, slice and callable are the same shape as float and are left alone. Their Vietnamese moves with the part of speech, nhap for the verb and import for the noun in "he thong import", and a row naming one rendering would fail G02 on the other. Needs pydocvi 0.1.11 for the identifier field, so every catalog is rewritten with the new X-Generator.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The rows behind tamnd/python-docs-vi-translator#58, now that a row can say two things.
What was measured
Over the 548 catalogs of the pinned mirror, counting only prose the glossary matcher finds the term in, and masking markup on the Vietnamese side so
:class:list`` does not read as the word "list":objectđối tượng63object46đối tượnglistdanh sách34list15danh sách, stands alonetypekiểu30type16kiểu, stands alonefloatsố thực4float4số thực, stands alonemodulemô-đun17module64module, kepttype,listandfloatstand alone because each of them names a thing in a table somewhere:typeis theargparsekeyword in a table ofargparsekeywords,listis a cell in thejsonconversion table next toarray,floatis a cell in thestructformat table next to_Float16.objectdoes not, because 35 of its 36 standalone entries are the index category and read "bytearray (object)" to somebody using the index.modulehad no row at all and no majority either, 64 to 17, and the split does not resolve by area: the tutorial runs the other way from the library reference. So it is decided on the reason rather than the count.mô-đunismodulespelled with a hyphen in it and carries nothing a reader does not already get frommodule, wheređối tượng,kiểu,danh sáchandsố thựcare Vietnamese words that mean something.bytecode,docstring,iterable,lambda,tracebackandREPLare already kept for exactly that reason.import,sliceandcallableare the same shape asfloatand are deliberately left as they are. Their Vietnamese moves with the part of speech,nhậpfor the verb andimportfor the noun in "hệ thống import", and a row naming one rendering would failG02on the other. They staykeep_enuntil somebody words them.What it moves
L02untranslated (hard)G03kept term lostG02rendering missingG04term left in English41 hard findings for 327 soft ones, and the soft ones are the point. Of
G03's 103,moduleis 80, and 65 of those 80 are machine output from the 2026-08-17 tier 1 run. The model was inventingmô-đunbecause the glossary said nothing aboutmodule, and now it will not. The same holds across the newG02andG04findings: 198 of the 362 are machine, and the next run clears them.The other 164 are human translations that disagree with each other, which is what a glossary is for and what a report is for.
reports/quality.mdnow reads 0.19 misses per machine entry against 0.05, and the reason it read 0.05 is that the glossary had nothing to say about the words the model was getting wrong.L02's remaining 45:object36,Lists3, three copyright notices, a Monty Python transcript and two one-offs.Listsis not folded intoliston purpose; it is a section heading three times, each followed by prose beginning "Lists are mutable sequences", and a heading is translated.Audit
548 catalogs, 41 checks, 29 passing, 2,545 findings. Hard failing:
P0126,P0327,L014,L0245.Glossary v2 to v3, 642 terms, 51 kept in English. Every catalog rewritten for
X-Generator: pydocvi 0.1.11.