Donate to Postulo/postulo

• https://buymeacoffee.com/tiagoagueda

---

See the documentation for more details on donation links.

Hold the drafts left out of the catalogues to a per-language ratchet (#910) #1076

Merged

tiagoagueda merged 1 commit from 910-draft-ratchet into main 2026-10-29 18:20:15 +00:00

Conversation 0 Commits 1 Files changed 5 +205 -16

tiagoagueda commented 2026-10-28 15:11:18 +00:00

Owner

• Copy link
• Copy Markdown

A draft that fails a check -- a lost placeholder, a plural form that drops the count, broken
markup -- is not compiled, so the page shows it in English. Nothing counted them: Weblate's
LibreTranslate add-on once left 1,684, and a new one was one more warning line among many.

messages.py check now counts them per catalogue set and language and compares the counts
with src/postulo/locale/excluded-drafts.txt, one <set> <language> <count> line each, a pair
not listed being zero (so a plugin repository without the file is held at zero). More than
recorded fails the check, naming the language and both numbers; it runs in CI on every pull
request, Weblate's included. Fewer than recorded is printed with the line to write, but does
not fail: the fix arrives in Weblate's pull request, which carries only catalogues, so the
commit after it lowers the number. The baseline is today's: ur 51, sw 19, id 1.

docs/TRANSLATING.md no longer says Weblate drafts new strings by machine (the add-on is off):
a new or changed string waits for a speaker, and the ratchet is described under The tool.

The 71 drafts themselves are Weblate work for speakers of Urdu, Swahili and Indonesian, so
the issue stays open for them.

Refs #910

Notes for review

• The ratchet: messages.py check counts, per catalogue set and language, the drafts left out of the .mo files, and compares them with src/postulo/locale/excluded-drafts.txt (today postulo id 1, postulo sw 19, postulo ur 51).
  • More than recorded fails, naming the language and both numbers.
  • Fewer prints the line to write. It does not fail, because Weblate's pull request, which carries only .po files, is what brings the fixes.
  • A missing file means zero.
• Docs: docs/TRANSLATING.md no longer says Weblate drafts by machine (four places), and it describes the ratchet.
• The issue stays open for the Weblate work: 71 drafts, all in the core component. Most need rewriting by a speaker.
• Watch: postulo-apprise has 30 excluded drafts of its own and will fail check when it repins, until it commits its own locale/excluded-drafts.txt.

🤖 Generated with Claude Code

A draft that fails a check -- a lost placeholder, a plural form that drops the count, broken markup -- is not compiled, so the page shows it in English. Nothing counted them: Weblate's LibreTranslate add-on once left 1,684, and a new one was one more warning line among many. `messages.py check` now counts them per catalogue set and language and compares the counts with src/postulo/locale/excluded-drafts.txt, one `<set> <language> <count>` line each, a pair not listed being zero (so a plugin repository without the file is held at zero). More than recorded fails the check, naming the language and both numbers; it runs in CI on every pull request, Weblate's included. Fewer than recorded is printed with the line to write, but does not fail: the fix arrives in Weblate's pull request, which carries only catalogues, so the commit after it lowers the number. The baseline is today's: ur 51, sw 19, id 1. docs/TRANSLATING.md no longer says Weblate drafts new strings by machine (the add-on is off): a new or changed string waits for a speaker, and the ratchet is described under The tool. The 71 drafts themselves are Weblate work for speakers of Urdu, Swahili and Indonesian, so the issue stays open for them. Refs #910 ## Notes for review - **The ratchet:** `messages.py check` counts, per catalogue set and language, the drafts left out of the `.mo` files, and compares them with `src/postulo/locale/excluded-drafts.txt` (today `postulo id 1`, `postulo sw 19`, `postulo ur 51`). - More than recorded fails, naming the language and both numbers. - Fewer prints the line to write. It does not fail, because Weblate's pull request, which carries only `.po` files, is what brings the fixes. - A missing file means zero. - **Docs:** `docs/TRANSLATING.md` no longer says Weblate drafts by machine (four places), and it describes the ratchet. - **The issue stays open** for the Weblate work: 71 drafts, all in the core component. Most need rewriting by a speaker. - **Watch:** postulo-apprise has 30 excluded drafts of its own and will fail `check` when it repins, until it commits its own `locale/excluded-drafts.txt`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

tiagoagueda added 1 commit 2026-10-28 15:11:18 +00:00

Hold the drafts left out of the catalogues to a per-language ratchet (#910) ... 765710db5a

A draft that fails a check -- a lost placeholder, a plural form that drops the count, broken
markup -- is not compiled, so the page shows it in English. Nothing counted them: Weblate's
LibreTranslate add-on once left 1,684, and a new one was one more warning line among many.

`messages.py check` now counts them per catalogue set and language and compares the counts
with src/postulo/locale/excluded-drafts.txt, one `<set> <language> <count>` line each, a pair
not listed being zero (so a plugin repository without the file is held at zero). More than
recorded fails the check, naming the language and both numbers; it runs in CI on every pull
request, Weblate's included. Fewer than recorded is printed with the line to write, but does
not fail: the fix arrives in Weblate's pull request, which carries only catalogues, so the
commit after it lowers the number. The baseline is today's: ur 51, sw 19, id 1.

docs/TRANSLATING.md no longer says Weblate drafts new strings by machine (the add-on is off):
a new or changed string waits for a speaker, and the ratchet is described under The tool.

The 71 drafts themselves are Weblate work for speakers of Urdu, Swahili and Indonesian, so
the issue stays open for them.

Refs #910

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tiagoagueda force-pushed 910-draft-ratchet from 765710db5a to 9c72e146fa 2026-10-29 10:23:48 +00:00 Compare

tiagoagueda force-pushed 910-draft-ratchet from 9c72e146fa to d04675dc89 2026-10-29 18:19:13 +00:00 Compare

tiagoagueda merged commit 401d30e050 into main 2026-10-29 18:20:15 +00:00

tiagoagueda deleted branch 910-draft-ratchet 2026-10-29 18:20:16 +00:00

tiagoagueda referenced this pull request from a commit 2026-10-29 18:20:17 +00:00

Hold the drafts left out of the catalogues to a per-language ratchet (#910) (#1076)

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

accessibility

Usable by everyone, including people with disabilities: one of the project's stated missions

  

authentication

Signing in, and proving who you are

  

breaking change

Changes behaviour or data in a way operators must act on

  

bug

Something does not do what it says it does

  

documentation

The wiki, the docs, or the words in the interface

  

enhancement

An improvement or a new capability

  

interface

The shape of the pages: what is where, and how it reads

  

internationalisation

Languages, regions, and the formats and symbols that go with them

  

observability

What an operator can see about a running instance: metrics, logs, health

  

performance

Uses fewer resources, or is more reliable, with no loss of features or accessibility

  

security

Keeping the code and the data secure: one of the project's stated missions

  

tier

1

Easy: small, self-contained, no prerequisites

  

tier

2

High-severity security: account access, personal data, the boundaries

  

tier

3

Foundations: prerequisite work that unblocks other issues

  

tier/4

Later: large features and long-horizon work

No labels

accessibility

authentication

breaking change

bug

documentation

enhancement

interface

internationalisation

observability

performance

security

tier

1

tier

2

tier

3

tier/4

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

Postulo/postulo!1076

No description provided.