Skip to content

Give back 130 entries that were copied through as markup - #55

Merged
tamnd merged 1 commit into
mainfrom
unqueue-130-roles-that-hid-prose
Aug 18, 2026
Merged

Give back 130 entries that were copied through as markup#55
tamnd merged 1 commit into
mainfrom
unqueue-130-roles-that-hid-prose

Conversation

@tamnd

@tamnd tamnd commented Aug 18, 2026

Copy link
Copy Markdown
Owner

Built with pydocvi 0.1.10 (tamnd/python-docs-vi-translator#59).

is_noop stripped the markup and asked whether anything was left. A role written :ref:`text <target>` has words a reader sees inside the backticks, and stripping took them away with the target.

So 130 entries were copied through here wearing # pydocvi: passthrough=noop, which is this tool's written claim that there was nothing in them to translate. There was:

:ref:`Documentation on attributes and methods on classes <class-attrs-and-methods>`.
``PYMEM_ALLOCATOR_PYMALLOC`` (``5``): :ref:`Python pymalloc memory allocator <pymalloc>`.
:term:`Filesystem encoding <filesystem encoding and error handler>`: :func:`sys.getfilesystemencoding`.

117 carry :ref:, the rest :rfc:, :term:, :doc: and :option:. All 130 display strings were read before the rule shipped.

They are untranslated now rather than copied, which is what they are. Sphinx renders the English for an empty msgstr and rendered it for the fuzzy copy too, so no page changes for a reader today. What changes is that they will be queued on the next fleet run and checked from now on, and neither had ever happened.

Audit

check before after
total findings 2,259 2,259
checks passing 29 of 41 29 of 41
hard checks failing 4 4

Nothing moves, which is the expected result: these entries were invisible to every check and are now merely untranslated, and an untranslated entry is not a finding. The coverage report is where the change shows, tier 6 going from 2,231 to 2,176 passthrough entries. Same 130, counted where they should have been counted all along.

pydocvi 0.1.10. is_noop stripped the markup and asked whether anything was
left, and a role written `:ref:`text <target>`` has words a reader sees inside
the backticks. Stripping took them away with the target.

So 130 entries were copied through here wearing `passthrough=noop`, which is
this tool's claim that there was nothing in them to translate. There was:
`A logging cookbook`, `Basic Tutorial`, `Configurable memory allocators`,
`Explanation of the object-oriented interface`. 117 of them are :ref:, and the
rest are :rfc:, :term:, :doc: and :option:.

They are untranslated now rather than copied, which is what they are. Sphinx
renders the English for an empty msgstr and rendered it for the fuzzy copy
too, so no page changes. What changes is that they will be queued on the next
run and checked from now on, and neither had ever happened.

Audit: 2,259 findings, 29 of 41 checks passing, 4 hard checks failing, all
unchanged. Coverage in tier 6 drops 2,231 to 2,176 passthrough entries, which
is the same 130 counted where they should have been counted all along.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant