Skip to content

docs(site): polish the Pages site with Start here, Ask DeepWiki and spacing fixes - #1143

Closed
HugoXK wants to merge 1 commit into
mainfrom
agent/site-deepwiki-polish
Closed

HugoXK wants to merge 1 commit into
mainfrom
agent/site-deepwiki-polish

Conversation

@HugoXK

@HugoXK HugoXK commented Nov 17, 2026

Copy link
Copy Markdown
Collaborator

Fixes #1126

What changed

  • Start here continuity: docs/docs.md now opens with what AgentDescent is, what it is good at, how to use it (with the offline demo output), and 10 self-evolution angles; it keeps the existing route cards, three supported paths, product surfaces and Go deeper.
  • Ask DeepWiki: a polished bottom-right launcher and chat panel. It asks ThinkFlowLab/agentdescent directly through the public MCP endpoint (ask_wiki_question, no key, no backend), renders safe Markdown, has message bubbles/avatars, copy, typing state, suggested prompts, a new-chat action, dark mode, a mobile bottom sheet, and an Open page choice.
  • Back-to-top fix: removed the .md-top override that left Material's top/margin-left/transform in place and stretched the fixed button; the homepage hides the Material pill and docs pages keep the small default control.
  • Top spacing: exp-hero / qs3-hero no longer use min-height:630px + 85px top padding with centred content; docs content top padding is reduced.
  • Readability/navigation: docs body 0.86rem, tables 0.78rem, nav 0.72rem; navigation.prune; favicon, footer version, site_author, edit_uri, extra.social.
  • New site files: docs/deepwiki.md, docs/llms.txt, docs/robots.txt (ThinkFlowLab sitemap), branded 404, and the DeepWiki CSS/JS assets.
  • No engine changes, no page deletions; docs/api.md is generated and untouched.

Verification at the tip

Tip SHA: f1c8d80

Ran:

  • mkdocs build --clean --strict (social disabled locally) -> pass
  • python tests/test_site_navigation.py site -> 147 rendered pages pass
  • node --test tests/javascript/experience.test.cjs -> 17 pass
  • node --check docs/assets/deepwiki.js -> pass

Not run:

  • social cards and Playwright layout — the docs workflow runs both on this PR
  • full pytest -q — the tests workflow runs it on this PR

Merge to main deploys https://thinkflowlab.github.io/agentdescent/ through the existing Pages workflow.

…pacing fixes

Add an integrated Start here overview, a polished Ask DeepWiki launcher/panel backed by the public MCP endpoint, the .md-top fix, tighter hero spacing, readability and navigation.prune, plus the DeepWiki page, llms.txt, robots.txt, branded 404 and site metadata. No engine changes; docs/api.md is untouched.
@HugoXK HugoXK added area:docs Documentation site (docs/, mkdocs.yml) and README documentation Improvements or additions to documentation labels Nov 17, 2026
@HugoXK

HugoXK commented Nov 17, 2026

Copy link
Copy Markdown
Collaborator Author

Superseded by #1144. #1143 was based before #1127 merged and conflicts on the same site files; #1144 carries only the chat-footer follow-up on the current main.

@HugoXK HugoXK closed this Nov 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Documentation site (docs/, mkdocs.yml) and README documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(site): polish the GitHub Pages site (Start here, Ask DeepWiki, top spacing)

1 participant