Menu ▾ ▴

#126 site: add /qa-glossary/ resource page with sectioned navigation

closed
nobody
None
2026-05-22
2026-05-22
Anonymous
No

Originally created by: TheoV823

Summary

  • New top-level practitioner reference at mnemehq.com/qa-glossary/: 43 Q&A entries and 47 glossary terms covering governance-before-generation, ADR enforcement, the Claude Code hook, and comparisons against RAG, linters, LLM-as-judge, and Cursor Rules.
  • Optimized for LLM citation (AEO/GEO): self-contained answers, plain noun definitions, no marketing voice. JSON-LD includes FAQPage (43 Question entities), DefinedTermSet (47 DefinedTerm entities), BreadcrumbList, and Article — the canonical schema patterns AI Overviews and Perplexity extract from.
  • Q&A organized into 6 topical sections + Glossary, with a sticky in-page anchor sub-nav under the main site nav. IntersectionObserver-based scroll-spy highlights the active section; the sub-nav is horizontally scrollable on mobile and auto-scrolls the active link into view.
  • Adds docs/qa-glossary.md as source-of-truth markdown for future edits.
  • Adds sitemap.xml entry and a Q&A link in the homepage top nav between Insights and Roadmap.

Files

  • New: site/qa-glossary/index.html, docs/qa-glossary.md
  • Modified: site/index.html (one-line nav addition), site/sitemap.xml (one entry)

Strategy

Per discussion in the source thread, this page is positioned as the canonical practitioner reference — one authoritative URL for AI assistants to cite when answering questions about Mneme HQ. Follow-up worth considering once authority builds: graduate high-intent questions (governance-before-generation, vs-RAG, vs-Cursor-Rules) into standalone concept/comparison pages, with this page remaining the canonical reference and linking out.

Test plan

  • [ ] Open /qa-glossary/ — confirm sticky sub-nav, scroll-spy highlighting, all 43 Q&A render across 6 sections, glossary <dl> alphabetized with 47 terms.
  • [ ] Paste rendered HTML into Google's Rich Results Test — confirm FAQPage, BreadcrumbList, and DefinedTermSet parse cleanly.
  • [ ] Mobile viewport ≤ 768px: sub-nav scrolls horizontally, active link auto-scrolls into view.
  • [ ] Homepage top nav shows the new Q&A link between Insights and Roadmap.
  • [ ] sitemap.xml parses (xmllint --noout site/sitemap.xml).
  • [ ] Post-deploy: submit URL to Google Search Console and Bing IndexNow.

Dependencies

Independent of [#125] (sticky-nav fix). Both PRs target main directly.

\U0001F916 Generated with Claude Code

Related

Tickets: #125

Discussion

  • Anonymous

    Anonymous - 2026-05-22

    Originally posted by: github-actions[bot]

    mneme self-governance check

    Mode: warn - verdicts are visible but do not block merge. Rollout plan: .mneme/README.md.

    Summary: 0 pass, 0 warn, 3 fail, 0 unknown

    verdict file
    ❌ FAIL site/index.html
    ❌ FAIL site/qa-glossary/index.html
    ❌ FAIL site/sitemap.xml

    Details

    site/index.html — FAIL FAIL [site_perf_001] anti_pattern "inline <script> running animation or DOM-mutation logic at parse time" -- trigger: inline Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [site_perf_001] anti_pattern "container divs with no height before JS populates them" -- trigger: height Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [site_perf_001] anti_pattern "synchronous Google Fonts CSS link in <head>" -- trigger: google Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [site_perf_001] anti_pattern "backdrop-filter on nav/menus applied unconditionally on mobile (GPU cost)" -- trigger: backdrop Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [site_perf_001] anti_pattern "scripts before <link rel=preconnect> hints" -- trigger: before Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. WARN [site_perf_001] constraint "No blocking scripts in <head> before preconnect hints" -- trigger: blocking Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [deploy_001] anti_pattern "python scripts/deploy_site.py" -- trigger: python deploy_site.py must always be run from the main repo root (C:/dev/mneme), never from a worktree directory FAIL [encoding_001] anti_pattern "Set-Content without -Encoding" -- trigger: content All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. FAIL [encoding_001] anti_pattern "open() without encoding= in Python" -- trigger: open All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. FAIL [encoding_001] anti_pattern "writeFileSync without encoding in Node.js" -- trigger: without All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. FAIL [encoding_001] anti_pattern "implicit encoding in any automation file write" -- trigger: any All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. Result: FAIL </details> <details><summary><code>site/qa-glossary/index.html</code> — FAIL</summary> FAIL [site_perf_001] anti_pattern "inline <script> running animation or DOM-mutation logic at parse time" -- trigger: inline Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [site_perf_001] anti_pattern "container divs with no height before JS populates them" -- trigger: height Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [site_perf_001] anti_pattern "synchronous Google Fonts CSS link in <head>" -- trigger: fonts Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [site_perf_001] anti_pattern "backdrop-filter on nav/menus applied unconditionally on mobile (GPU cost)" -- trigger: backdrop Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [site_perf_001] anti_pattern "scripts before <link rel=preconnect> hints" -- trigger: scripts Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. WARN [site_perf_001] constraint "No blocking scripts in <head> before preconnect hints" -- trigger: blocking Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [deploy_001] anti_pattern "python scripts/deploy_site.py" -- trigger: python deploy_site.py must always be run from the main repo root (C:/dev/mneme), never from a worktree directory FAIL [encoding_001] anti_pattern "Set-Content without -Encoding" -- trigger: content All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. FAIL [encoding_001] anti_pattern "open() without encoding= in Python" -- trigger: open All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. FAIL [encoding_001] anti_pattern "writeFileSync without encoding in Node.js" -- trigger: without All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. FAIL [encoding_001] anti_pattern "implicit encoding in any automation file write" -- trigger: any All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. Result: FAIL </details> <details><summary><code>site/sitemap.xml</code> — FAIL</summary> FAIL [site_perf_001] anti_pattern "inline <script> running animation or DOM-mutation logic at parse time" -- trigger: running Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [site_perf_001] anti_pattern "container divs with no height before JS populates them" -- trigger: before Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [site_perf_001] anti_pattern "scripts before <link rel=preconnect> hints" -- trigger: before Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. WARN [site_perf_001] constraint "No blocking scripts in <head> before preconnect hints" -- trigger: before Site pages with inline JavaScript must defer animations and pre-size dynamic containers to prevent CLS and TBT regressions on mobile. FAIL [deploy_001] anti_pattern "python scripts/deploy_site.py" -- trigger: python deploy_site.py must always be run from the main repo root (C:/dev/mneme), never from a worktree directory FAIL [encoding_001] anti_pattern "Set-Content without -Encoding" -- trigger: encoding All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. FAIL [encoding_001] anti_pattern "open() without encoding= in Python" -- trigger: encoding All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. FAIL [encoding_001] anti_pattern "writeFileSync without encoding in Node.js" -- trigger: encoding All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. FAIL [encoding_001] anti_pattern "implicit encoding in any automation file write" -- trigger: encoding All automation that reads or writes text files must specify the encoding explicitly. UTF-8 for all site, doc, config, and source files in this repo. Result: FAIL </details> <sub>Generated by `.github/workflows/mneme-check.yml` · query = PR title + file path · scope = repo-governance paths.</sub> <!-- Sticky Pull Request Commentmneme-check --> </script>
     

  • Anonymous

    Anonymous - 2026-05-22

    Ticket changed by: TheoV823

    • status: open --> closed
     

Log in to post a comment.

Auth0 Logo