Philosophy
Documentation tools have a habit of becoming projects of their own.
You start with a few Markdown files.
Then come the configuration files. The overrides. The ejecting. The swizzling.
The “surely there's a better way to do this.”
There should be.
The principles
Your documentation should adapt to your project, not the other way around.
ctrl alt doc gives you sensible defaults and the configuration you need to make them yours. You shouldn't have to dismantle the framework to change how it behaves.
Your documentation is the product.
The framework handles navigation, search, presentation and the machinery around it so you can concentrate on what you're actually trying to explain.
You shouldn't need to become an expert in a documentation framework before you can document your project.
Write your Markdown. Configure what you need. Ship.
Every feature earns its place.
If something makes documentation harder to build, maintain or understand, we're probably doing it wrong.
We don't want you to think about the framework.
ctrl alt doc