Skip to content

Validate FAQ metadata before skipping section notes - #365

Merged
biodranik merged 2 commits into
masterfrom
fix/faq-frontmatter-validation
Nov 3, 2026
Merged

biodranik merged 2 commits into
masterfrom
fix/faq-frontmatter-validation

Conversation

@biodranik

@biodranik biodranik commented Nov 1, 2026 •

Copy link
Copy Markdown
Member

FAQ section bodies contain an unrendered maintenance note, while their titles, descriptions and menu labels are visible to readers. Validate reader-visible metadata before applying the body exemption, reuse the parsed English metadata, and check unchanged strings and runtime placeholders in one field loop.

The regression covers copied English metadata, translated metadata with the unchanged note, incorrect register, and valid and stale source-wording exemptions. A stale exemption must produce an ERROR. Hook and contributor documentation describe staged validation and paragraph-based fingerprints.

Validation:

  • Python 3.12: npm test passes 25 tooling tests and 185 round-trip checks; all 3,169 corpus files round-trip.
  • All 1,836 checked translations have identical ordered diagnostics to master.
  • The regression fails when declaration validation is disabled for FAQ notes.
  • The Korean FAQ stub from [i18n/korean]: Add New Translation Language, Korean #363 reports its three untranslated metadata fields.
  • Zola 0.23.6 build, sh -n .githooks/pre-commit, and git diff --check pass.
  • CI passes, including the pinned Zola build and checkout browser regressions.

Related to #363 and #364's independent navigation and donation fallback fixes. #368 adds required-field, parser, product-name and rendering-policy validation on a separate branch from master.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 1, 2026 •

Copy link
Copy Markdown

Deploying organicmaps with  Cloudflare Pages  Cloudflare Pages

Latest commit: 2bca0d9
Status: ✅  Deploy successful!
Preview URL: https://f7588440.organicmaps.pages.dev
Branch Preview URL: https://fix-faq-frontmatter-validati.organicmaps.pages.dev

View logs

Signed-off-by: Alexander Borsuk <me@alex.bio>
Signed-off-by: Alexander Borsuk <me@alex.bio>
@biodranik
biodranik merged commit d5697b5 into master Nov 3, 2026
4 checks passed
@biodranik
biodranik deleted the fix/faq-frontmatter-validation branch November 3, 2026 16:39

This branch was successfully deployed

1 active deployment
production — 2bca0d99 Deployed Nov 3, 2026 by biodranik via Check Zola build #1244
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