[Docs] Complete German public documentation and structured metadata localization #20

New Issue

2026-08-07T14:50:28+02:00

zemion commented

2026-08-07 14:50:28 +02:00

Context

The manifest-driven public documentation exporter and the public /docs surface now use the same static DocumentationTopic sources as the installed Help Center. The generated catalog now contains 68 modules and 313 static topics; 143 topics have complete German title, summary, and body content. Structured German localization is versioned and currently complete for 16 of 183 localizable topics.

The generated gap report is committed at addideas-govoplan-website/docs/DOCUMENTATION_COVERAGE.md.

Required Work

Give every public topic complete German title, summary, and body content; German is the reference target.
Add a versioned localization contract for structured steps, fields, limitations, consequences, and verification metadata.
Give every user-facing module at least one scope-conditioned workflow topic and one field/consequence reference.
Give every configurable module an administrator topic covering permissions, policy provenance, retention, and operational consequences.
Keep configured-instance facts in runtime documentation providers and clearly distinguish them from publishable product facts.
Add a non-regression coverage gate to the public documentation generation check.

Acceptance Criteria

Public documentation generation is deterministic and remains the single source of published product content.
All static topics have complete German reference content.
Every module gap in the generated report is either resolved or has an explicit, reviewed non-public rationale.
CI rejects coverage regressions and stale generated output.

Related: govoplan-docs#16 and add-ideas/addideas-govoplan-website#1.

## Context The manifest-driven public documentation exporter and the public `/docs` surface now use the same static `DocumentationTopic` sources as the installed Help Center. The generated catalog now contains 68 modules and 313 static topics; 143 topics have complete German title, summary, and body content. Structured German localization is versioned and currently complete for 16 of 183 localizable topics. The generated gap report is committed at `addideas-govoplan-website/docs/DOCUMENTATION_COVERAGE.md`. ## Required Work - [ ] Give every public topic complete German title, summary, and body content; German is the reference target. - [x] Add a versioned localization contract for structured steps, fields, limitations, consequences, and verification metadata. - [ ] Give every user-facing module at least one scope-conditioned workflow topic and one field/consequence reference. - [ ] Give every configurable module an administrator topic covering permissions, policy provenance, retention, and operational consequences. - [ ] Keep configured-instance facts in runtime documentation providers and clearly distinguish them from publishable product facts. - [x] Add a non-regression coverage gate to the public documentation generation check. ## Acceptance Criteria - Public documentation generation is deterministic and remains the single source of published product content. - All static topics have complete German reference content. - Every module gap in the generated report is either resolved or has an explicit, reviewed non-public rationale. - CI rejects coverage regressions and stale generated output. Related: govoplan-docs#16 and add-ideas/addideas-govoplan-website#1.

zemion added the

type

docs

module/docs area/docs

codex/ready labels 2026-08-07 14:50:28 +02:00

zemion referenced this issue

2026-08-07 15:08:42 +02:00

[Feature] Publish full public GovOPlaN documentation #16

zemion referenced this issue

2026-08-21 00:07:21 +02:00

[User Story] Author, review, and publish tenant semantic documentation #21

zemion commented

2026-08-22 05:21:07 +02:00

Starting a bounded reference-locale batch: complete every static Mail topic in German and add exact high-risk contextual-help coverage for the new POP3 legacy-import workflow. This advances the all-module coverage target without requiring product-policy choices.

zemion added

and removed

labels 2026-08-22 05:21:08 +02:00

zemion commented

2026-08-22 05:48:59 +02:00

Progress slice released in Mail v0.1.21.

Evidence:

All 15 static Mail DocumentationTopic contributions now contain complete German title, summary, and body translations; a regression test enforces this for every Mail topic.
The public catalog built from all 68 workspace manifests reports Mail topics=15, missing German=0, missing coverage=[].
The legacy POP3 workflow now also has structured field and operational-consequence metadata plus 25 exact contextual-help identities, and the handbook explains focused F1 access.
Mail commit/tag: fd808336bc84aeaa508d8fa7da919e8c1e21103c / v0.1.21.
Workspace release catalog: fe784cc5627016b2254cba707a073cd2fb1f48fa.
Strict platform inventory, manifest checks, 150 Mail backend tests, Mail WebUI tests, 59 module permutations, and 8/8 browser conformance tests passed.

This is a complete Mail-owned localization batch; the cross-module Docs umbrella remains open for the remaining module gaps.

Progress slice released in Mail v0.1.21. Evidence: - All 15 static Mail DocumentationTopic contributions now contain complete German title, summary, and body translations; a regression test enforces this for every Mail topic. - The public catalog built from all 68 workspace manifests reports Mail topics=15, missing German=0, missing coverage=[]. - The legacy POP3 workflow now also has structured field and operational-consequence metadata plus 25 exact contextual-help identities, and the handbook explains focused F1 access. - Mail commit/tag: fd808336bc84aeaa508d8fa7da919e8c1e21103c / v0.1.21. - Workspace release catalog: fe784cc5627016b2254cba707a073cd2fb1f48fa. - Strict platform inventory, manifest checks, 150 Mail backend tests, Mail WebUI tests, 59 module permutations, and 8/8 browser conformance tests passed. This is a complete Mail-owned localization batch; the cross-module Docs umbrella remains open for the remaining module gaps.

zemion commented

2026-08-22 05:49:55 +02:00

Starting the next autonomous Docs-owned batch: complete German title, summary, and body coverage for the six remaining Docs topics, add a manifest-wide regression contract, verify the public export reports no Docs module gap, and release/synchronize the catalog. This requires no product-policy decision.

zemion commented

2026-08-22 06:18:10 +02:00

Released Docs v0.1.20 as the next German-reference coverage batch.

Evidence:

Docs commit: d6560b343a
Annotated tag: v0.1.20 (verified to peel exactly to the release commit)
Workspace catalog sync: 81fe0f46803f40cd8aa3c5e9f6f8153bd5f61e66
All 9 Docs-owned public topics now have complete German title, summary, and body coverage.
Added a regression test requiring 9/9 German-complete topics and no Docs coverage gaps.
Corrected stale package-version metadata while releasing.

Verification:

29 Docs backend tests
Docs WebUI typecheck
manifest registry: 68/68
public catalog: Docs missing German topics = 0; Docs missing coverage = []
full focused workspace gate: 59 module permutations, full-product bundle, 8/8 Playwright conformance scenarios, and downstream UI checks

This removes the Docs-owned localization gap. The umbrella remains open for German/reference gaps still owned by other modules.

Released Docs v0.1.20 as the next German-reference coverage batch. Evidence: - Docs commit: d6560b343a9da9e5db3fdc5f2d9e39e852b024a6 - Annotated tag: v0.1.20 (verified to peel exactly to the release commit) - Workspace catalog sync: 81fe0f46803f40cd8aa3c5e9f6f8153bd5f61e66 - All 9 Docs-owned public topics now have complete German title, summary, and body coverage. - Added a regression test requiring 9/9 German-complete topics and no Docs coverage gaps. - Corrected stale package-version metadata while releasing. Verification: - 29 Docs backend tests - Docs WebUI typecheck - manifest registry: 68/68 - public catalog: Docs missing German topics = 0; Docs missing coverage = [] - full focused workspace gate: 59 module permutations, full-product bundle, 8/8 Playwright conformance scenarios, and downstream UI checks This removes the Docs-owned localization gap. The umbrella remains open for German/reference gaps still owned by other modules.

zemion commented

2026-08-22 06:19:22 +02:00

Starting the next bounded cross-module batch: REST and SOAP are the two remaining modules whose public-catalog gap is localization-only (one reference topic each). I am adding complete German title/summary/body coverage plus owner-level regression tests, releasing both modules, and validating them together through the workspace gate. No product or policy decision is involved.

zemion commented

2026-08-22 06:46:16 +02:00

Released the REST/SOAP localization-only batch.

REST:

commit 570cf256fea4a683744e6d7a32201b03b5443134
annotated tag v0.1.19 (tag object ca15d43941810bd7aac710ebb7e2ce76932bf748, verified target = release commit)

SOAP:

commit e5140050038ea19197a94269cedf3dff7da2aeb8
annotated tag v0.1.19 (tag object 4a55be45ed6e261548c53b510be60eb1abc71692, verified target = release commit)

Workspace catalog:

88543ab115632372c32774406302879fbb17d5eb

Results:

both one-topic module catalogs now have complete German title/summary/body coverage
both modules now report missing coverage = []
German-complete topics increased 65 -> 67
modules with catalog gaps decreased 66 -> 64
owner regression suites: 4/4 REST and 4/4 SOAP
full focused gate passed: release-package resolution, all backend/integration suites, 59 WebUI permutations, full-product bundle, 8/8 Playwright conformance tests, and downstream UI checks

The umbrella remains open for the remaining owner-module batches.

Released the REST/SOAP localization-only batch. REST: - commit 570cf256fea4a683744e6d7a32201b03b5443134 - annotated tag v0.1.19 (tag object ca15d43941810bd7aac710ebb7e2ce76932bf748, verified target = release commit) SOAP: - commit e5140050038ea19197a94269cedf3dff7da2aeb8 - annotated tag v0.1.19 (tag object 4a55be45ed6e261548c53b510be60eb1abc71692, verified target = release commit) Workspace catalog: - 88543ab115632372c32774406302879fbb17d5eb Results: - both one-topic module catalogs now have complete German title/summary/body coverage - both modules now report missing coverage = [] - German-complete topics increased 65 -> 67 - modules with catalog gaps decreased 66 -> 64 - owner regression suites: 4/4 REST and 4/4 SOAP - full focused gate passed: release-package resolution, all backend/integration suites, 59 WebUI permutations, full-product bundle, 8/8 Playwright conformance tests, and downstream UI checks The umbrella remains open for the remaining owner-module batches.

zemion commented

2026-08-22 06:47:35 +02:00

Starting the next autonomous documentation-contract batch:

Tasks: translate the one remaining topic, classify the existing unified inbox guidance as its user workflow, improve the German copy, and enforce complete German + workflow/reference coverage.
Postbox: translate the three remaining public topics and enforce complete 9/9 German coverage.

Both changes describe already-implemented behavior and require no policy choice. I will release them together through one full workspace gate.

Starting the next autonomous documentation-contract batch: - Tasks: translate the one remaining topic, classify the existing unified inbox guidance as its user workflow, improve the German copy, and enforce complete German + workflow/reference coverage. - Postbox: translate the three remaining public topics and enforce complete 9/9 German coverage. Both changes describe already-implemented behavior and require no policy choice. I will release them together through one full workspace gate.

zemion commented

2026-08-22 07:15:20 +02:00

Released the Tasks/Postbox documentation-contract batch.

Tasks v0.1.20:

commit faf6b3305a8967cc2c81657acacf0f3636390abc
annotated tag object 9a9b72bb5a930890ee8a5aa1d634995b60b02bfe, verified target = release commit
all 3 topics now have complete German title/summary/body
unified work inbox is now the scope-conditioned user workflow; the existing Quick Access topic remains the field/consequence reference
owner suite: 16/16

Postbox v0.1.19:

commit b24d291cc8def98312cd40f80abe95f809baa2fc
annotated tag object 54e84d484d0a7b349b89fb59fe6091a11fa1e362, verified target = release commit
all 9 topics now have complete German title/summary/body
owner suite: 60/60 plus Postbox UI structure/interface checks

Workspace:

catalog sync 72279de2c0ba4a975e84af15f52379942b5eb232
German-complete topics: 67 -> 71 of 298
modules with gaps: 64 -> 62
both Tasks and Postbox now report missing coverage = []
full focused gate passed: all backend/integration suites, 59 WebUI permutations, full-product bundle, 8/8 Playwright conformance tests, and downstream UI checks

The umbrella remains open for subsequent owner batches.

Released the Tasks/Postbox documentation-contract batch. Tasks v0.1.20: - commit faf6b3305a8967cc2c81657acacf0f3636390abc - annotated tag object 9a9b72bb5a930890ee8a5aa1d634995b60b02bfe, verified target = release commit - all 3 topics now have complete German title/summary/body - unified work inbox is now the scope-conditioned user workflow; the existing Quick Access topic remains the field/consequence reference - owner suite: 16/16 Postbox v0.1.19: - commit b24d291cc8def98312cd40f80abe95f809baa2fc - annotated tag object 54e84d484d0a7b349b89fb59fe6091a11fa1e362, verified target = release commit - all 9 topics now have complete German title/summary/body - owner suite: 60/60 plus Postbox UI structure/interface checks Workspace: - catalog sync 72279de2c0ba4a975e84af15f52379942b5eb232 - German-complete topics: 67 -> 71 of 298 - modules with gaps: 64 -> 62 - both Tasks and Postbox now report missing coverage = [] - full focused gate passed: all backend/integration suites, 59 WebUI permutations, full-product bundle, 8/8 Playwright conformance tests, and downstream UI checks The umbrella remains open for subsequent owner batches.

zemion commented

2026-08-22 07:18:43 +02:00

Starting the next autonomous public-documentation coverage batch for Portal, Views, and Quick Access. Scope: promote their already implemented service-directory, View-selection, and Quick Access rail flows to explicitly scope-conditioned workflow topics; classify Quick Access privacy/DSAR consequences as its field/effect reference; complete all six remaining German topic baselines; add owner-level coverage regressions; release all three modules; and update/verify the workspace catalog. No product-policy decision or behavior change is involved.

zemion commented

2026-08-22 07:45:53 +02:00

Completed and released the Portal / Views / Quick Access public-documentation coverage batch.\n\nReleased:\n- Portal v0.1.19: 91f5a332a8905461ef0391d3741529f35eda8afc (annotated tag object 9a5ddf201fb7ef743dfae1fa3ae6e941b2e45607)\n- Views v0.1.19: acd0d3bdaeabf436f015b265e437207a155615ec (annotated tag object 465a854caaa3e30b5287ba63dceb457194d27e96)\n- Quick Access v0.1.19: ac2f47bd7a5ce73080fd80a9c26a1f037ff85d34 (annotated tag object af7f1713599b819df463cae9a35453c946e4c9df)\n- Workspace catalog pins: e07b3487e300446b68153a03ae146d4882140bb1\n\nCoverage result: all six remaining German topic baselines completed; existing service-directory, View-selection, and Quick Access rail flows are now explicit scope-conditioned workflows; Quick Access DSAR field/effect consequences are an explicit reference. Portal, Views, and Quick Access each report zero public-catalog gaps. Aggregate coverage is now 77/298 fully German topics and 59 gap-bearing modules (from 71/298 and 62).\n\nVerification: owner suites Portal 11/11, Views 45/45, Quick Access 15/15; owner frontend structural checks; 68/68 manifest/architecture validation; full tools/checks/check-focused.sh, including 59 WebUI permutations, full-product bundle budgets, 8/8 Playwright conformance tests, and downstream component/type/structure checks. Remote main commits, annotated tag objects, and peeled tag targets were verified through the Gitea API.

Completed and released the Portal / Views / Quick Access public-documentation coverage batch.\n\nReleased:\n- Portal v0.1.19: `91f5a332a8905461ef0391d3741529f35eda8afc` (annotated tag object `9a5ddf201fb7ef743dfae1fa3ae6e941b2e45607`)\n- Views v0.1.19: `acd0d3bdaeabf436f015b265e437207a155615ec` (annotated tag object `465a854caaa3e30b5287ba63dceb457194d27e96`)\n- Quick Access v0.1.19: `ac2f47bd7a5ce73080fd80a9c26a1f037ff85d34` (annotated tag object `af7f1713599b819df463cae9a35453c946e4c9df`)\n- Workspace catalog pins: `e07b3487e300446b68153a03ae146d4882140bb1`\n\nCoverage result: all six remaining German topic baselines completed; existing service-directory, View-selection, and Quick Access rail flows are now explicit scope-conditioned workflows; Quick Access DSAR field/effect consequences are an explicit reference. Portal, Views, and Quick Access each report zero public-catalog gaps. Aggregate coverage is now 77/298 fully German topics and 59 gap-bearing modules (from 71/298 and 62).\n\nVerification: owner suites Portal 11/11, Views 45/45, Quick Access 15/15; owner frontend structural checks; 68/68 manifest/architecture validation; full `tools/checks/check-focused.sh`, including 59 WebUI permutations, full-product bundle budgets, 8/8 Playwright conformance tests, and downstream component/type/structure checks. Remote main commits, annotated tag objects, and peeled tag targets were verified through the Gitea API.

zemion commented

2026-08-22 07:47:30 +02:00

Starting a decision-free seed-boundary documentation batch across 17 one-topic modules: Assets, Booking, Certificates, Consultation, Contracts, Evaluation, Facilities, Grants, Helpdesk, Inspections, Learning, Permits, Procurement, Resources, Tickets, Transparency, and Wiki. Each repository is currently a deliberately non-invasive seed with no frontend/runtime workflow. Its single topic already enumerates owned domain fields and the consequence that no runtime API, persistence, migration, or WebUI exists yet. I will make that reference semantics explicit, add a complete German baseline, add owner regression assertions, release v0.1.19 per module, and update the workspace pins. This changes no product behavior or policy.

zemion commented

2026-08-22 08:22:00 +02:00

Completed the autonomous seed-boundary public-documentation batch.

Released v0.1.19 for Assets (27cfe2e), Booking (1400a9f), Certificates (b50c15e), Consultation (aff4df9), Contracts (e75ec88), Evaluation (4d44357), Facilities (13131f8), Grants (4ca6535), Helpdesk (064ec61), Inspections (51935b1), Learning (a8f6e97), Permits (1ad0582), Procurement (0e35520), Resources (5ced341), Tickets (b4bb52d), Transparency (8f6cb0a), and Wiki (572cb91). Workspace pin integration: GovOPlaN/govoplan cd498dc.

Each deliberately non-invasive seed now supplies a complete German static topic, declares the topic as a reference, records the unavailable-runtime seed_boundary consequence, and has an owner regression for these guarantees. The public projection moved from 77/298 to 94/298 German-complete topics and from 59 to 42 modules with coverage gaps.

Validation passed: all 17 owner suites; manifest shape/architecture checks for 68/68 modules; public catalog projection; full tools/checks/check-focused.sh, including backend and migration matrices, 59 WebUI module permutations, full-product bundle budget, 8/8 Playwright conformance scenarios, and downstream type/structure checks. Remote main commits, annotated tag objects, and peeled tag targets were verified through the Gitea API.

This does not claim runtime feature completion: Tickets #1 and Wiki #1 correctly remain open. The documentation umbrella remains open for the remaining 42 gap modules.

Completed the autonomous seed-boundary public-documentation batch. Released `v0.1.19` for Assets (`27cfe2e`), Booking (`1400a9f`), Certificates (`b50c15e`), Consultation (`aff4df9`), Contracts (`e75ec88`), Evaluation (`4d44357`), Facilities (`13131f8`), Grants (`4ca6535`), Helpdesk (`064ec61`), Inspections (`51935b1`), Learning (`a8f6e97`), Permits (`1ad0582`), Procurement (`0e35520`), Resources (`5ced341`), Tickets (`b4bb52d`), Transparency (`8f6cb0a`), and Wiki (`572cb91`). Workspace pin integration: GovOPlaN/govoplan `cd498dc`. Each deliberately non-invasive seed now supplies a complete German static topic, declares the topic as a `reference`, records the unavailable-runtime `seed_boundary` consequence, and has an owner regression for these guarantees. The public projection moved from 77/298 to 94/298 German-complete topics and from 59 to 42 modules with coverage gaps. Validation passed: all 17 owner suites; manifest shape/architecture checks for 68/68 modules; public catalog projection; full `tools/checks/check-focused.sh`, including backend and migration matrices, 59 WebUI module permutations, full-product bundle budget, 8/8 Playwright conformance scenarios, and downstream type/structure checks. Remote main commits, annotated tag objects, and peeled tag targets were verified through the Gitea API. This does not claim runtime feature completion: Tickets #1 and Wiki #1 correctly remain open. The documentation umbrella remains open for the remaining 42 gap modules.

zemion commented

2026-08-22 08:51:42 +02:00

Completed the next decision-free, localization-only documentation batch.

Released Ops v0.1.19 (f4f0931), Poll v0.1.19 (bf25e88), Audit v0.1.19 (f71434e), and Workflow v0.1.21 (fa0bdde). Workspace release requirements and developer meta-package pins are integrated in GovOPlaN/govoplan 79c4cb0.

All 12 existing topics now have complete German title, summary, and body translations. Their already-correct workflow/reference/system classifications and behavior boundaries were preserved. Workflow package surfaces were aligned by correcting its stale __version__ to 0.1.21; no runtime semantics changed.

The public projection moved from 94/298 to 106/298 German-complete topics and from 42 to 38 modules with coverage gaps. Owner suites passed (Ops 7, Poll 73 with one skip, Audit 19, Workflow 53), as did the 68/68 manifest/architecture checks and full tools/checks/check-focused.sh: backend and migration matrices, shared UI contracts, 59 WebUI permutations, full-product bundle budget, 8/8 Playwright conformance scenarios, and downstream type/structure checks.

Remote main commits, annotated tag objects, and peeled tag targets were verified through the Gitea API. Ops #2 and Workflow #14 remain open because this slice does not implement deployment controls or remove the compatibility facade. The documentation umbrella remains open for the remaining 38 gap modules.

Completed the next decision-free, localization-only documentation batch. Released Ops `v0.1.19` (`f4f0931`), Poll `v0.1.19` (`bf25e88`), Audit `v0.1.19` (`f71434e`), and Workflow `v0.1.21` (`fa0bdde`). Workspace release requirements and developer meta-package pins are integrated in GovOPlaN/govoplan `79c4cb0`. All 12 existing topics now have complete German title, summary, and body translations. Their already-correct workflow/reference/system classifications and behavior boundaries were preserved. Workflow package surfaces were aligned by correcting its stale `__version__` to `0.1.21`; no runtime semantics changed. The public projection moved from 94/298 to 106/298 German-complete topics and from 42 to 38 modules with coverage gaps. Owner suites passed (Ops 7, Poll 73 with one skip, Audit 19, Workflow 53), as did the 68/68 manifest/architecture checks and full `tools/checks/check-focused.sh`: backend and migration matrices, shared UI contracts, 59 WebUI permutations, full-product bundle budget, 8/8 Playwright conformance scenarios, and downstream type/structure checks. Remote main commits, annotated tag objects, and peeled tag targets were verified through the Gitea API. Ops #2 and Workflow #14 remain open because this slice does not implement deployment controls or remove the compatibility facade. The documentation umbrella remains open for the remaining 38 gap modules.

zemion commented

2026-08-22 20:47:26 +02:00

Implemented and released the versioned structured-documentation localization foundation and the first owner migrations.

Delivered:

Core v0.1.37 (562d278): DocumentationTopic now supports structured translation contract v1 with exact-shape, key, version, string, and non-text-leaf validation.
Docs v0.1.21 (12fe709): runtime locale overlay, localized safe projection, structured coverage reporting, and a monotonic baseline check integrated into --check.
Decisions, Mandates, Parties, and Services v0.1.19: eight additional public topics now have complete German reference content; applicable DSAR consequence metadata is structurally localized.
Website publication 9944fcc: refreshed deterministic catalog/report, German structured-content rendering/search, fallback notice, and reviewed coverage baseline.
Workspace v0.1.37 (85caa8d) composes the released versions.

Coverage moved from 123 to 131 complete German topics out of 313 and from 38 to 34 gap modules. Structured German coverage starts at 4 complete topics out of 177 localizable topics. The baseline now fails on regressions in complete German topics, structured-contract adoption, structured completeness, missing topics, and gap modules.

Verification: targeted owner/Core/Docs suites passed; npm run docs:generate, npm run docs:check, and the website production build passed; the full 68-module focused gate passed, including 63 WebUI permutations and 8/8 browser conformance tests.

Keeping this umbrella open: 182 static German topic gaps, 173 structured-metadata gaps, and the remaining per-module workflow/reference/administrator coverage still need migration.

Implemented and released the versioned structured-documentation localization foundation and the first owner migrations. Delivered: - Core v0.1.37 (562d278): `DocumentationTopic` now supports structured translation contract v1 with exact-shape, key, version, string, and non-text-leaf validation. - Docs v0.1.21 (12fe709): runtime locale overlay, localized safe projection, structured coverage reporting, and a monotonic baseline check integrated into `--check`. - Decisions, Mandates, Parties, and Services v0.1.19: eight additional public topics now have complete German reference content; applicable DSAR consequence metadata is structurally localized. - Website publication 9944fcc: refreshed deterministic catalog/report, German structured-content rendering/search, fallback notice, and reviewed coverage baseline. - Workspace v0.1.37 (85caa8d) composes the released versions. Coverage moved from 123 to 131 complete German topics out of 313 and from 38 to 34 gap modules. Structured German coverage starts at 4 complete topics out of 177 localizable topics. The baseline now fails on regressions in complete German topics, structured-contract adoption, structured completeness, missing topics, and gap modules. Verification: targeted owner/Core/Docs suites passed; `npm run docs:generate`, `npm run docs:check`, and the website production build passed; the full 68-module focused gate passed, including 63 WebUI permutations and 8/8 browser conformance tests. Keeping this umbrella open: 182 static German topic gaps, 173 structured-metadata gaps, and the remaining per-module workflow/reference/administrator coverage still need migration.

zemion commented

2026-08-22 21:15:15 +02:00

Second autonomous owner-migration batch released:

Reporting v0.1.19 (f85e0fe): complete German content for both public topics; a reporting:definition:read-conditioned governed-BI workflow with prerequisites, steps, limitations, operational consequences, and verification; a structured DSAR consequence reference; owner regression tests.
Search v0.1.19 (6c5545a): complete German content for both public topics; a search:result:read-conditioned global/contextual-search workflow with ACL-safe steps, limitations, index-operation consequences, and verification; a structured DSAR consequence reference; owner regression tests.
Workspace composition 41ca242 and website publication d0635d4 are pushed.

Both modules now have no public-documentation coverage gaps. Aggregate coverage moved from 131 to 135 complete German topics out of 313, structured German coverage from 4/177 to 8/181, and gap modules from 34 to 32. The reviewed monotonic baseline was advanced to those values.

Verification passed: Reporting 22/22 backend tests; Search 22 backend tests with the optional PostgreSQL environment test skipped; owner Ruff/format and WebUI contracts; all 68 manifest checks; deterministic docs check and website production build; complete focused gate including 63 WebUI permutations, full-product bundle budgets, and 8/8 Playwright conformance tests.

Keeping the umbrella open for the remaining 178 German title/body gaps, 173 pre-existing structured-metadata gaps, and remaining module workflow/reference/administrator migrations.

Second autonomous owner-migration batch released: - Reporting v0.1.19 (f85e0fe): complete German content for both public topics; a `reporting:definition:read`-conditioned governed-BI workflow with prerequisites, steps, limitations, operational consequences, and verification; a structured DSAR consequence reference; owner regression tests. - Search v0.1.19 (6c5545a): complete German content for both public topics; a `search:result:read`-conditioned global/contextual-search workflow with ACL-safe steps, limitations, index-operation consequences, and verification; a structured DSAR consequence reference; owner regression tests. - Workspace composition 41ca242 and website publication d0635d4 are pushed. Both modules now have no public-documentation coverage gaps. Aggregate coverage moved from 131 to 135 complete German topics out of 313, structured German coverage from 4/177 to 8/181, and gap modules from 34 to 32. The reviewed monotonic baseline was advanced to those values. Verification passed: Reporting 22/22 backend tests; Search 22 backend tests with the optional PostgreSQL environment test skipped; owner Ruff/format and WebUI contracts; all 68 manifest checks; deterministic docs check and website production build; complete focused gate including 63 WebUI permutations, full-product bundle budgets, and 8/8 Playwright conformance tests. Keeping the umbrella open for the remaining 178 German title/body gaps, 173 pre-existing structured-metadata gaps, and remaining module workflow/reference/administrator migrations.

zemion commented

2026-08-23 02:16:43 +02:00

Shipped the next owner-documentation batch:

Identity Trust v0.1.19: scope-conditioned public-key/assurance workflow plus governed DSAR reference, complete German body and structured metadata.
Payments v0.1.21: payment-request/reconciliation workflow plus DSAR reference, complete German body and structured metadata.
Projects v0.1.19: project-planning workflow plus DSAR reference, complete German body and structured metadata; also added the missing keyboard focus-visible contract.
Risk Compliance v0.1.19: sanctions/evidence workflow plus DSAR reference, complete German body and structured metadata.

Coverage moved from 135/313 to 143/313 complete German topics. Structured German coverage moved from 8/181 to 16/183; missing structured translations fell to 167, and gap modules fell from 32 to 28. The generated catalog and non-regression baseline are published in add-ideas/addideas-govoplan-website@9d42c01.

Verification: all four owner suites and lint checks, manifest registry (68/68), deterministic docs check and website build, full focused workspace gate, 63 WebUI permutations, bundle budgets, and 8 Playwright conformance tests passed. This issue remains open for the remaining 170 German topic translations and 28 module-level gaps.

Shipped the next owner-documentation batch: - Identity Trust v0.1.19: scope-conditioned public-key/assurance workflow plus governed DSAR reference, complete German body and structured metadata. - Payments v0.1.21: payment-request/reconciliation workflow plus DSAR reference, complete German body and structured metadata. - Projects v0.1.19: project-planning workflow plus DSAR reference, complete German body and structured metadata; also added the missing keyboard focus-visible contract. - Risk Compliance v0.1.19: sanctions/evidence workflow plus DSAR reference, complete German body and structured metadata. Coverage moved from 135/313 to 143/313 complete German topics. Structured German coverage moved from 8/181 to 16/183; missing structured translations fell to 167, and gap modules fell from 32 to 28. The generated catalog and non-regression baseline are published in add-ideas/addideas-govoplan-website@9d42c01. Verification: all four owner suites and lint checks, manifest registry (68/68), deterministic docs check and website build, full focused workspace gate, 63 WebUI permutations, bundle budgets, and 8 Playwright conformance tests passed. This issue remains open for the remaining 170 German topic translations and 28 module-level gaps.

zemion commented

2026-08-23 19:58:32 +02:00

German reference-debt wave published (2026-08-23).\n\nCoverage moved from the last published baseline to:\n- German-complete static topics: 143 -> 182 of 322\n- Missing German static topics: 170 -> 140\n- Modules with documented coverage gaps: 28 -> 20\n- Structured German workflow/reference contracts: 16 -> 39 of 189\n- Catalogued modules/topics: 68/313 -> 72/322\n\nPublished owner releases:\n- v0.1.19: approvals, dashboard, dist-lists, notifications, committee, encryption, forms-runtime, organizations\n- v0.1.20: dms, erp, fit-connect\n- v0.1.21: records, xrechnung\n\nThe translations cover permission-scoped workflows, settings, field semantics, limitations, operational consequences, and verification metadata. DMS, ERP, FIT-Connect, XRechnung, and Records no longer have public documentation gaps. The encryption text documents the implemented server-envelope/E2EE boundary without choosing a tenant policy.\n\nComposition/catalog commits:\n- GovOPlaN/govoplan@c50f699\n- add-ideas/addideas-govoplan-website@7b3ca3c\n\nVerification:\n- all affected owner test suites and Ruff checks passed\n- 72/72 manifest and architecture checks passed\n- website documentation check and production build passed\n- full focused workspace gate passed, including 63 WebUI permutations, full-product bundle budget, 8 Playwright conformance tests, and downstream UI structure tests\n\nRemaining gap modules: access, addresses, admin, calendar, campaigns, cases, connectors, dashboard, dataflow, datasources, files, forms, identity, idm, policy, scheduling, templates, tenancy, voting, workflow_engine.\n\nThe dashboard gap is intentionally still reported: German content and structured reference metadata are complete, but there is no route-specific permission contract from which to claim a scope-conditioned user workflow. This umbrella should remain open for the remaining public German and exact/contextual-help debt.

German reference-debt wave published (2026-08-23).\n\nCoverage moved from the last published baseline to:\n- German-complete static topics: **143 -> 182** of 322\n- Missing German static topics: **170 -> 140**\n- Modules with documented coverage gaps: **28 -> 20**\n- Structured German workflow/reference contracts: **16 -> 39** of 189\n- Catalogued modules/topics: **68/313 -> 72/322**\n\nPublished owner releases:\n- v0.1.19: approvals, dashboard, dist-lists, notifications, committee, encryption, forms-runtime, organizations\n- v0.1.20: dms, erp, fit-connect\n- v0.1.21: records, xrechnung\n\nThe translations cover permission-scoped workflows, settings, field semantics, limitations, operational consequences, and verification metadata. DMS, ERP, FIT-Connect, XRechnung, and Records no longer have public documentation gaps. The encryption text documents the implemented server-envelope/E2EE boundary without choosing a tenant policy.\n\nComposition/catalog commits:\n- GovOPlaN/govoplan@c50f699\n- add-ideas/addideas-govoplan-website@7b3ca3c\n\nVerification:\n- all affected owner test suites and Ruff checks passed\n- 72/72 manifest and architecture checks passed\n- website documentation check and production build passed\n- full focused workspace gate passed, including 63 WebUI permutations, full-product bundle budget, 8 Playwright conformance tests, and downstream UI structure tests\n\nRemaining gap modules: access, addresses, admin, calendar, campaigns, cases, connectors, dashboard, dataflow, datasources, files, forms, identity, idm, policy, scheduling, templates, tenancy, voting, workflow_engine.\n\nThe dashboard gap is intentionally still reported: German content and structured reference metadata are complete, but there is no route-specific permission contract from which to claim a scope-conditioned user workflow. This umbrella should remain open for the remaining public German and exact/contextual-help debt.

zemion commented

2026-08-23 20:52:53 +02:00

German reference localization burn-down — final progress (2026-08-23)

This supersedes the intermediate coverage figures posted earlier in this issue.

Public catalog: 72 modules / 322 static topics.
German-complete topics: 143 → 264 (+121).
Topics missing German title/summary/body: 170 → 58 (-112).
Modules with any documentation gap: 28 → 5 (-23).
Structured German contract coverage: 16 → 40 of 190.

Remaining bounded debt

campaigns: 31 untranslated topics.
files: 15 untranslated topics.
connectors: 7 untranslated topics plus a user workflow and field/consequence reference.
dataflow: 5 untranslated topics plus a user workflow and field/consequence reference.
dashboard: fully German and structured, but still lacks a permission-conditioned user workflow. This is intentionally not fabricated: the current product contract has no route-specific Dashboard read scope, so resolving it requires either an explicit read permission or a decision that every authenticated user is in scope.

Releases published

First wave: Approvals, Dashboard, Distribution Lists, Notifications, Committee, Encryption, Forms Runtime, Organizations, DMS, ERP, FIT-Connect, XRechnung, and Records.
Extended wave: Access v0.1.21, Admin v0.1.20, Policy v0.1.21, Scheduling v0.1.20, Addresses v0.1.19, Calendar v0.1.20, Cases v0.1.21, Datasources v0.1.22, IDM v0.1.22, Forms v0.1.21, Identity v0.1.19, Templates v0.1.19, Tenancy v0.1.19, Voting v0.1.19, and Workflow Engine v0.1.20.

Verification and publication

All 15 extended-wave owner suites passed: 768 tests, 2 skipped.
Manifest contract passed for all 72 modules; affected version alignment passed for all 15 repositories.
Public docs generation, regression check, TypeScript build, and Vite build passed.
Full focused workspace gate passed, including 63 WebUI module permutations, the full-product bundle, and 8 Playwright conformance tests.
Workspace composition: fe83290d56a5862eabc84599d86795d2a49b3b1f.
Published website catalog: 34bcbdda3348935f53a06f41b7ef7c50a6ed3db4.

The umbrella remains open for the five explicitly listed modules and the separate structured-metadata migration. A native-speaker editorial review remains advisable, but no manual verification is required for release correctness.

## German reference localization burn-down — final progress (2026-08-23) This supersedes the intermediate coverage figures posted earlier in this issue. - Public catalog: **72 modules / 322 static topics**. - German-complete topics: **143 → 264** (**+121**). - Topics missing German title/summary/body: **170 → 58** (**-112**). - Modules with any documentation gap: **28 → 5** (**-23**). - Structured German contract coverage: **16 → 40 of 190**. ### Remaining bounded debt - `campaigns`: 31 untranslated topics. - `files`: 15 untranslated topics. - `connectors`: 7 untranslated topics plus a user workflow and field/consequence reference. - `dataflow`: 5 untranslated topics plus a user workflow and field/consequence reference. - `dashboard`: fully German and structured, but still lacks a permission-conditioned user workflow. This is intentionally not fabricated: the current product contract has no route-specific Dashboard read scope, so resolving it requires either an explicit read permission or a decision that every authenticated user is in scope. ### Releases published - First wave: Approvals, Dashboard, Distribution Lists, Notifications, Committee, Encryption, Forms Runtime, Organizations, DMS, ERP, FIT-Connect, XRechnung, and Records. - Extended wave: Access `v0.1.21`, Admin `v0.1.20`, Policy `v0.1.21`, Scheduling `v0.1.20`, Addresses `v0.1.19`, Calendar `v0.1.20`, Cases `v0.1.21`, Datasources `v0.1.22`, IDM `v0.1.22`, Forms `v0.1.21`, Identity `v0.1.19`, Templates `v0.1.19`, Tenancy `v0.1.19`, Voting `v0.1.19`, and Workflow Engine `v0.1.20`. ### Verification and publication - All 15 extended-wave owner suites passed: **768 tests, 2 skipped**. - Manifest contract passed for all 72 modules; affected version alignment passed for all 15 repositories. - Public docs generation, regression check, TypeScript build, and Vite build passed. - Full focused workspace gate passed, including **63 WebUI module permutations**, the full-product bundle, and **8 Playwright conformance tests**. - Workspace composition: `fe83290d56a5862eabc84599d86795d2a49b3b1f`. - Published website catalog: `34bcbdda3348935f53a06f41b7ef7c50a6ed3db4`. The umbrella remains open for the five explicitly listed modules and the separate structured-metadata migration. A native-speaker editorial review remains advisable, but no manual verification is required for release correctness.

zemion commented

2026-08-23 21:32:12 +02:00

German reference localization burn-down — completed static coverage (2026-08-23)

This supersedes both earlier progress comments from today; the translation-only residual wave has now also shipped.

Public catalog: 72 modules / 322 static topics.
German-complete topics: 143 → 322 (+179).
Topics missing German title/summary/body: 170 → 0 (-170; complete).
Modules with any documentation gap: 28 → 1 (-27).
Structured German contract coverage: 16 → 42 of 192; the newly promoted Connectors and Dataflow archetypes include German structured translations, so the remaining structured debt stays at 150 rather than increasing.

Sole remaining module-level gap

dashboard: all 3 topics are German-complete and its two structured topics are complete. The remaining user-workflow flag requires a permission-model decision: either introduce an explicit Dashboard read scope or declare the Dashboard universally available to authenticated users. No scope was invented in documentation.

Final residual releases

Connectors v0.1.23 (d86894b): 7 translations, permission-conditioned workflow, field/consequence reference, structured German contract.
Dataflow v0.1.21 (08c1ecb): 5 translations, permission-conditioned workflow, explicit reference archetypes, structured German contract.
Files v0.1.21 (74c2609): 15 translations.
Campaign v0.1.25 (b41f23c): 31 translations and corrected package-version alignment.

These follow the 28 module releases listed in the preceding comment, for 32 module releases in the complete localization wave.

Verification and publication

Final four owner suites: 795 tests passed, plus 6 new documentation-contract tests.
Manifest registry passed for all 72 modules; internal version alignment passed for all four releases.
Public docs generation/check, TypeScript, and Vite builds passed against a regression baseline of 322 complete / 0 missing / 1 gap.
Full focused workspace gate passed again, including 63 WebUI permutations, full-product bundle budgets, and 8 Playwright conformance tests.
Final workspace composition: a886a9b3def386fc9f533ea78028d4f58fcef302.
Final published catalog: 040ff06961b4a843a24192259ec1f288766fe1b7.

No manual verification is required for release correctness. A native-speaker editorial pass remains advisable. The umbrella should remain open only for the Dashboard scope decision and the separate 150-topic structured-metadata migration.

## German reference localization burn-down — completed static coverage (2026-08-23) This supersedes both earlier progress comments from today; the translation-only residual wave has now also shipped. - Public catalog: **72 modules / 322 static topics**. - German-complete topics: **143 → 322** (**+179**). - Topics missing German title/summary/body: **170 → 0** (**-170; complete**). - Modules with any documentation gap: **28 → 1** (**-27**). - Structured German contract coverage: **16 → 42 of 192**; the newly promoted Connectors and Dataflow archetypes include German structured translations, so the remaining structured debt stays at 150 rather than increasing. ### Sole remaining module-level gap - `dashboard`: all 3 topics are German-complete and its two structured topics are complete. The remaining user-workflow flag requires a permission-model decision: either introduce an explicit Dashboard read scope or declare the Dashboard universally available to authenticated users. No scope was invented in documentation. ### Final residual releases - Connectors `v0.1.23` (`d86894b`): 7 translations, permission-conditioned workflow, field/consequence reference, structured German contract. - Dataflow `v0.1.21` (`08c1ecb`): 5 translations, permission-conditioned workflow, explicit reference archetypes, structured German contract. - Files `v0.1.21` (`74c2609`): 15 translations. - Campaign `v0.1.25` (`b41f23c`): 31 translations and corrected package-version alignment. These follow the 28 module releases listed in the preceding comment, for 32 module releases in the complete localization wave. ### Verification and publication - Final four owner suites: **795 tests passed**, plus **6 new documentation-contract tests**. - Manifest registry passed for all 72 modules; internal version alignment passed for all four releases. - Public docs generation/check, TypeScript, and Vite builds passed against a regression baseline of 322 complete / 0 missing / 1 gap. - Full focused workspace gate passed again, including **63 WebUI permutations**, full-product bundle budgets, and **8 Playwright conformance tests**. - Final workspace composition: `a886a9b3def386fc9f533ea78028d4f58fcef302`. - Final published catalog: `040ff06961b4a843a24192259ec1f288766fe1b7`. No manual verification is required for release correctness. A native-speaker editorial pass remains advisable. The umbrella should remain open only for the Dashboard scope decision and the separate 150-topic structured-metadata migration.

zemion commented

2026-08-24 02:10:18 +02:00

Completed and published the final acceptance slice.

Dashboard v0.1.20 (ec240ed) introduces the grantable dashboard:dashboard:read scope, a dashboard_user role template, backend 403 enforcement, and matching frontend route/navigation guards. Its configurable-home documentation is now a scope-conditioned workflow.
Core v0.1.38 (d2e4913) adds validated owner-localized structured-translation merging; all remaining structured German metadata was added in 45 owning-module releases without changing stable IDs, API paths, field IDs, keys, or permission scopes.
The deterministic public catalog now reports 72 modules, 322/322 German-complete static topics, 193/193 German-complete structured contracts, zero missing translations, and zero module gaps.
Publication commits: workspace 3f75ca8; website/catalog 2ecb31d.

Verification passed: all 72 manifest/architecture contracts, owner suites, strict platform inventory, deterministic docs check, 63 optional-module WebUI permutations, the full-product bundle and budgets, and 8/8 Playwright conformance journeys. Remote main and the peeled release-tag target were verified for all 47 release repositories.

All acceptance criteria of this umbrella are now met, so it is being closed. Exact high-risk field/action F1 content remains separately tracked by Core #284.

Completed and published the final acceptance slice. - Dashboard `v0.1.20` (`ec240ed`) introduces the grantable `dashboard:dashboard:read` scope, a `dashboard_user` role template, backend 403 enforcement, and matching frontend route/navigation guards. Its configurable-home documentation is now a scope-conditioned workflow. - Core `v0.1.38` (`d2e4913`) adds validated owner-localized structured-translation merging; all remaining structured German metadata was added in 45 owning-module releases without changing stable IDs, API paths, field IDs, keys, or permission scopes. - The deterministic public catalog now reports 72 modules, 322/322 German-complete static topics, 193/193 German-complete structured contracts, zero missing translations, and zero module gaps. - Publication commits: workspace `3f75ca8`; website/catalog `2ecb31d`. Verification passed: all 72 manifest/architecture contracts, owner suites, strict platform inventory, deterministic docs check, 63 optional-module WebUI permutations, the full-product bundle and budgets, and 8/8 Playwright conformance journeys. Remote `main` and the peeled release-tag target were verified for all 47 release repositories. All acceptance criteria of this umbrella are now met, so it is being closed. Exact high-risk field/action F1 content remains separately tracked by Core #284.

zemion closed this issue

2026-08-24 02:10:18 +02:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: GovOPlaN/govoplan-docs#20