Skip to content

docs(site): add Engineering Practices page - #89

Merged
FabioLeitao merged 2 commits into
mainfrom
docs/engineering-practices-page
Aug 24, 2026
Merged

FabioLeitao merged 2 commits into
mainfrom
docs/engineering-practices-page

Conversation

@FabioLeitao

Copy link
Copy Markdown
Contributor

Summary

  • New bilingual page (pt-BR/en) at praticas-de-engenharia.html — four engineering principles: fail-closed by default, pinned dependencies + cooldown window, integrity verification before trust, metadata-first scanning.
  • Each principle links to a real, already-public artifact in DataBoar/data-boar (docs/SECURITY.md, .github/dependabot.yml, docs/RELEASE_INTEGRITY.md, docs/GLOSSARY.md) — no unpublished/private tooling is named.
  • Linked from footer Posicionamento/Positioning column; partials synced via scripts/sync-site-chrome.py; added to sitemap.xml.

Test plan

  • python3 scripts/sync-site-chrome.py --check — no drift
  • bash scripts/check-all.sh — full local gate green (site surface, guardrails incl. anti-overclaim/anti-LLM, faro privacy, ruff, js syntax)

New bilingual page (pt-BR/en) at praticas-de-engenharia.html listing four
engineering principles -- fail-closed by default, pinned dependencies with
a cooldown window, integrity verification before trust, metadata-first
scanning -- each linked to the real, already-public artifact that backs
it (docs/SECURITY.md, .github/dependabot.yml, docs/RELEASE_INTEGRITY.md,
docs/GLOSSARY.md in DataBoar/data-boar). No unpublished internal tooling
is named.

Linked from the footer's Posicionamento/Positioning column (partials
synced via scripts/sync-site-chrome.py) and added to sitemap.xml.
@greptile-apps

greptile-apps Bot commented Aug 24, 2026 •

Copy link
Copy Markdown

Greptile Summary

The PR adds a bilingual Engineering Practices page and integrates it into site navigation and discovery.

  • Documents four engineering principles with links to public repository artifacts.
  • Synchronizes the new footer link across the site.
  • Adds the page to the sitemap and bilingual-page test inventory.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains.

Important Files Changed

Filename Overview
praticas-de-engenharia.html Adds the complete bilingual Engineering Practices page with existing site chrome and public supporting links.
tests/test_guardrails.py Adds the new page to the fixed bilingual guardrail inventory.
partials/site-chrome/footer.html Adds the bilingual Engineering Practices link to the canonical footer.
sitemap.xml Publishes the new page in the sitemap.

Reviews (2): Last reviewed commit: "test(guardrails): add praticas-de-engenh..." | Re-trigger Greptile

</header>

<!-- ============ PT-BR ============ -->
<div data-lang-panel="pt-BR">

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Bilingual page lacks guardrail coverage

The new page uses Portuguese and English panels, but it is absent from the fixed bilingual-page test inventory. A later missing or mislabeled panel would therefore pass the local gate and leave one translation inaccessible.

Fix in Cursor Fix in Claude Code Fix in Codex

…inventory (Greptile review, PR#89)

test_bilingual_panels_present checks a fixed tuple of page names for both
data-lang-panel="pt-BR" and data-lang-panel="en". The new Engineering
Practices page already implements both panels correctly but was missing
from that tuple, so a future regression on either panel would pass the
local gate silently. Both panels were already present before this fix --
this only closes the coverage gap.
@FabioLeitao
FabioLeitao merged commit 476ad50 into main Aug 24, 2026
11 checks passed
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