Skip to content

chore: add governance and community navigation - #161

Merged
srpatcha merged 1 commit into
masterfrom
chore/governance-community-navigation
Sep 12, 2026
Merged

srpatcha merged 1 commit into
masterfrom
chore/governance-community-navigation

Conversation

@srpatcha

@srpatcha srpatcha commented Sep 11, 2026 •

Copy link
Copy Markdown
Member

Closing Issue

Fixes #160

Summary

  • replace stale generated agent guidance with repository-specific static-site instructions
  • enforce the pinned organization linked-issue policy
  • repair the malformed pull request template while requiring a same-repository closing issue
  • preserve all six published Wiki pages in docs/wiki/
  • expose Wiki, Discussions, Issues, Projects, and AGENTS.md through the README and shared site footer

Validation

  • PASS: python YAML parse plus exact uses and policy_ref pin assertions
  • PASS: Markdown encoding, balanced fence, and relative-target checks across 9 relevant files
  • PASS: node --check js/site-chrome.js
  • PASS: git diff --check
  • PASS: byte comparison for all 6 Wiki source/copy pairs (fc /b, no differences)
  • PASS: rendered footer contains all 5 required community URLs
  • PASS: all 5 community URLs returned HTTP 200
  • PASS WITH RETRIES: focused Chromium link suite, 24 passed and 1 Playwright trace-copy flake that passed on retry; no broken-link assertion failed
  • PASS WITH RETRIES: full Chromium suite, 128 passed and 2 Playwright trace-copy flakes that passed on retry
  • BASELINE BLOCKER: HTML validation reports 476 existing errors across unchanged HTML pages; no HTML file is changed by this pull request
  • PASS: changed-file validation and editor diagnostics report no errors
  • REMOTE BLOCKER: PR Quality Check failed because the existing workflow installs only Chromium and then runs all 520 configured browser tests; Firefox/WebKit launches fail with missing executable errors. CodeQL, canonical-count, and auto-assignment checks passed.

Risk and Rollout

Low. The workflow is pinned to a reviewed immutable commit and has read-only permissions. Site behavior changes only in shared footer links. Rollback is a normal revert of this commit.

Screenshots or Logs

Not applicable; the visual structure is unchanged and rendered link behavior was exercised in Chromium.

Additional Notes

The Wiki repository was read only. Its six published Markdown pages were copied byte-for-byte; no Wiki, settings, default branch, merge, close, or force operation was performed.

@srpatcha srpatcha changed the title \ chore: add governance and community navigation\ chore: add governance and community navigation Sep 11, 2026
@srpatcha
srpatcha marked this pull request as ready for review September 12, 2026 01:00
@srpatcha
srpatcha merged commit 9928b42 into master Sep 12, 2026
5 of 6 checks passed
srpatcha added a commit that referenced this pull request Oct 6, 2026
playwright.config.js defines chromium, firefox and webkit projects, but the
workflow installed only chromium. Every firefox and webkit test failed at
browserType.launch ('Executable doesn't exist'), so 'test' was red on every
PR, including merged #151, #157 and #161.
srpatcha added a commit that referenced this pull request Oct 6, 2026
…nfig + content fixes (#163)

* fix(ci): make lint-readme configs load (lychee.toml, .markdownlint.yml)

lychee exited 3 before checking a single link: its config keys are
top-level, so the `[lychee]` table header made the whole file an
unknown-field parse error. Dropping the header keeps every existing
exclude and lets the offline check run (64 OK, 0 errors).

The lint-readme workflow was ported from embeddedos-org/embeddedos-org
in 6fc5b85 without the .markdownlint.yml it runs with there (9475a30),
so markdownlint ran on defaults and reported 476 errors, 253 of them
MD060 table-pipe style. Port that config (MD013 tables exempt, MD060
consistent) and add MD024 siblings_only: the ecosystem guide repeats
Overview/Key Features/Architecture under every chapter; duplicate
headings under the same parent are still reported.

Refs #162

* docs: fix the markdown lint-readme reports, incl. broken guide TOC

Content fixes for the 174 markdownlint errors left after the config
commit, following the embeddedos-org cleanup (87c3262):

- ecosystem guide: the TOC links to em-dash anchors but chapter
  headings used `--`, so all 18 chapter links were dead (MD051). Use
  the em dash the TOC and the front-matter title already use.
- ecosystem guide: the body H1 duplicated the front-matter title and
  every Part was another H1 (MD025). Drop the duplicate and demote the
  Part/Appendices subtree one level, so there is one title.
- `text` on 27 bare diagram/tree fences (MD040); autolink bare URLs
  and emails, backtick the repo name in merge-proposal (MD034); join
  example quotes with `>` (MD028); missing blank lines (MD022/MD032),
  extra blank line (MD012), stray H1 in CLAUDE.md (MD025); byline and
  colophon kept on two lines via a hard break instead of
  emphasis-only paragraphs (MD036); prose reflowed to 80 columns
  (MD013) with wording unchanged.

Fixes #162

* ci(pr-check): install the browsers the Playwright config runs

playwright.config.js defines chromium, firefox and webkit projects, but the
workflow installed only chromium. Every firefox and webkit test failed at
browserType.launch ('Executable doesn't exist'), so 'test' was red on every
PR, including merged #151, #157 and #161.

* test(seo): read sitemap.xml as a document, not a rendered page

Firefox renders XML in its own viewer, where page.textContent('body') never
resolves, so 'sitemap.xml is valid' timed out on Firefox once the browser
was actually installed. The test now fetches the file and checks it is a
<urlset> naming the site.
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.

Governance: enforce linked issues and expose community resources

1 participant