https://technomensch.github.io/knowledge-graph/docs-updates KMGraph Docs Updates 2026-04-09T00:00:00.000Z https://github.com/jpmonette/feed Knowledge Management Graph Blog https://technomensch.github.io/knowledge-graph/img/square.png <![CDATA[Home page redesigned - clearer audience, context grid, demo GIF]]> https://technomensch.github.io/knowledge-graph/docs-updates/2026/04/09/homepage-rewrite 2026-04-09T00:00:00.000Z The KMGraph home page has been redesigned based on user feedback. The previous page didn't immediately answer who KMGraph is for or what it does - visitors had to read too far before the value was clear.

What changed​

New banner - updated to lead with the audience hook, the problem, and the solution in a single visual:

  • "Using an AI coding assistant? KMGraph is for you."
  • "KMGraph remembers what you and your tools forget."
  • "Lessons Learned. Decisions. Institutional Knowledge."

Context grid - a 2×2 grid immediately answers "what does it bridge?": sessions, models, tools, and teammates.

What it stores - three plain-language bullets mapping directly to the tricolon: lessons learned, decisions, and institutional knowledge.

Audience badges - explicit audience callout: Developer · Vibe-Coder · Prompt Engineer · Open-Source Maintainer · Small Agile Team.

Demo GIF - capture-lesson demo now shown on the home page so visitors see the tool in action before being asked to install it.

]]> Marc Kaplan https://github.com/technomensch <![CDATA[Documentation restructured — Diátaxis IA, search, demos]]> https://technomensch.github.io/knowledge-graph/docs-updates/2026/04/08/docusaurus-restructure 2026-04-08T00:00:00.000Z The KMGraph documentation site has been fully restructured using the Diátaxis information architecture: Tutorials, How-to Guides, Reference, and Concepts. Every page now has a clear intent, and navigation reflects what you're trying to do — not internal feature groupings.

What changed​

New structure

  • Quickstart — zero-to-first-lesson in 5 minutes with terminal demo GIFs
  • 15 how-to guides — task-oriented recipes: capture from a bugfix, write a pattern, sync across machines, integrate with Obsidian/Notion/NotebookLM, and more
  • Reference — commands, skills, agents, hooks, and templates in sortable tables; condensed from the old COMMAND-GUIDE
  • Concepts — explanatory pages for the mental models behind KMGraph (why it exists, the four pillars, personal vs project KGs, the automation layer)

Demo GIFs

Every core command now has a VHS terminal recording embedded in the Quickstart page: init, status, recall, capture-lesson, and session-summary.

Search

Full-text search is active via @orama/plugin-docusaurus-v3 — no crawler required.

Glossary tooltips

KMGraph-specific terms (lesson, ADR, KG, skill, agent, capture, recall, session, handoff, hook, pattern) now show definition tooltips on hover via the new <Glossary> component.

Files removed​

The following legacy pages were split into the new structure and removed:

  • GETTING-STARTED.md → Quickstart + Troubleshooting + reference/agents + reference/skills
  • CHANGELOG-DOCS-ONLY.md → seeded into this docs-updates/ feed
  • _test-layout.md, DEPLOYMENT-SITEMAP.md, NAVIGATION-INDEX.md — orphaned, removed
]]> Marc Kaplan https://github.com/technomensch <![CDATA[Homepage visuals, UX improvements, and doc fixes]]> https://technomensch.github.io/knowledge-graph/docs-updates/github-docs-visuals 2026-02-26T00:00:00.000Z Initial documentation site improvements: homepage journey flow diagram, expanded scenarios, and accessibility fixes.

Homepage Visuals & UX​

  • Journey Flow Mermaid Diagram: Replaced bulleted scenarios with a narrative left-to-right flow.
  • Expanded Scenarios: Added trigger moments and future payoffs (including agile sprint retrospectives).
  • "About This Project" Repositioning: Moved project backstory to the bottom of the page in a collapsed info box.
  • "How It Works" Concrete Rewrite: Clarified markdown-based storage and absence of external database dependencies.
  • Feature Discoverability: Set the full feature list to be open by default.
  • Intro Sentence: Added a guiding sentence before the journey flow diagram.
  • Typography: Removed emdashes from descriptive text for a cleaner documentation style.

General Documentation Updates​

  • Universal Installer Clarification: Added details to GETTING-STARTED.md regarding behavioral expectations and terminal/file access requirements.
  • Fragment Links & Anchors: Fixed broken internal navigation links in COMMAND-GUIDE.md and NAVIGATION-INDEX.md.
  • Accessibility Fixes: Added accTitle and accDescr to all new diagrams for Section 508 compliance.
  • Typo Fix: Corrected missing space in index.md Outcome card.
]]> Marc Kaplan https://github.com/technomensch