mirror of https://github.com/testthedocs/awesome-docs.git synced 2026-07-15 22:02:42 -05:00

Files

sven d2eb3c152e Reorganize VitePress docs sections and refine metadata search indexing

Move topic pages to section index routes, standardize card-based content presentation, and simplify metadata typing while improving local search indexing for EnhancedLink entries. Refresh theme styling and replace unstable external links to keep metadata builds reliable.

2026-04-13 17:15:17 +02:00

7.8 KiB

Raw Permalink Blame History

Site Generators

Static site generators and frameworks commonly used for documentation portals, API references, and knowledge bases.

Framework-Specific Generators

JavaScript Ecosystem

Language-Specific

Lightweight and Minimal

Enterprise and Advanced

Experimental and Niche

Specialized Solutions

Extensions and Themes

Docsify Extensions

Hugo Extensions

MkDocs Extensions

Sphinx Extensions and Themes

Search Solutions

Choosing the Right Generator

Consider These Factors

Team Skills - Match framework and language to team expertise.
Project Size - Single-repo docs versus multi-repo publishing.
Customization - Required control over theme and information architecture.
Performance - Build speed and runtime performance expectations.
Maintenance - Ongoing operational and upgrade complexity.

Quick Recommendations

Getting started fast: VitePress or Docusaurus.
Python-heavy teams: MkDocs or Sphinx.
Performance-first teams: Astro or Zola.
Minimal setup needs: Docsify or 11ty.
Large organization docs: Antora or GitBook.

7.8 KiB Raw Permalink Blame History