This plan addresses refactoring, cleanup, organization, and key design principles (KISS, YAGNI, SoC, SRP, DRY) with beginner‑friendly names.

1. Reorganize code modules

   • src/parser.ts → unified parser setup
   • src/builders/navigation.ts → buildNav (doc links + sidebar)
   • src/builders/head.ts → buildHead
   • src/builders/scripts.ts → buildScripts (client interactivity)
   • src/utils.ts → loadDoc, groupByFolder, buildToc
   • src/config.ts → central config + docs list
   • src/handlers.ts → appHandler (handleRequest + renderDoc)

2. Centralize CSS URLs

   • Create helper in config.ts to resolve all stylesheet paths once

3. Remove unneeded runtime plugins

   • Drop remarkLint (move to dev chain)

4. Rename for brevity & clarity

   • docLinksHtml → buildNav
   • sidebarHtml → buildSidebar
   • generateTableOfContents → buildToc
   • groupDocsByFolder → groupByFolder
   • processDocument → renderDoc
   • handleRequest → appHandler

5. Clean up

   • Delete empty folders (src/client, src/server)