For full-page or full-site generation, Dokly has two larger AI flows:
- Generate page — turn a brief into a single complete page, ready to edit.
- Generate site — turn a product description into a full docs site outline with stub pages.
These are heavier than inline AI actions. They consume more credits and take 10–30 seconds.
Generate page#
Open a new page
From the page tree, click + New page or hit the slash menu's /generate block on a blank page.
Write a brief
A few sentences describing what the page should cover. The more specific, the better. Good brief: Bad brief:
Pick the doc type
The generator adjusts structure based on type:
Pick a tone
Friendly, neutral, technical, or formal. Defaults to your project's brand voice if you've configured one in Settings.
Generate, then edit
The page appears in the editor. Treat it as a first draft — read it, fix what's wrong, add what's missing. The AI is good at structure and bad at the details only you know.
Generate site#
For a brand-new project with no pages yet, Generate site scaffolds the whole information architecture.
From the empty project, click 'Generate site'
Available on any project with zero pages. Disappears once you've created at least one page.
Describe your product in 2–3 sentences
The generator uses this to decide page titles, structure, and section grouping.
Pick a template
Templates seed the structure differently — API docs put OpenAPI reference at the top, product docs put a quickstart, internal wikis put architecture decisions.
Review the proposed sidebar
You see a preview of every page that will be generated. Reorder, rename, or delete pages before committing.
Generate
Each page is generated in parallel. Total time: ~30 seconds for a 10–20 page site.
Site generation gets you 70% of the way to a coherent docs site. The other 30% is product-specific knowledge the AI doesn't have. Plan to spend a few hours editing after generation — this is normal and expected.
Costs#
Operation Approximate credits Inline action (improve, expand) 1–3 Generate single page 20–50 Generate site (10 pages) 200–500
Free plan includes a small monthly allowance — enough for a few inline actions a day. Starter and Pro include enough credits for normal writing flows, including occasional page generations. See AI credits for current bucket sizes.
What works well, what doesn't#
Works well:
- Stub pages with the right structure and headings
- Boilerplate (prerequisites, "what you'll learn", "next steps")
- Code examples in common languages
- Migration guides between similar tools
Doesn't work well (yet):
- Anything specific to your product (the AI doesn't know your API)
- Long technical reasoning (it'll be plausible-sounding but wrong)
- Pricing or feature claims (always verify against your source of truth)
The right mental model: AI-generated docs are a fast first draft. Your edits are what makes them accurate.