Troubleshoot documentation generation

Use the visible run and page statuses to identify whether a problem occurred during source import, outline creation or page generation.

The source is not ready

Return to connection troubleshooting if the repository is still importing or failed to import. A ZIP that uploads successfully still needs to pass validation and source processing.

The outline misses important topics

Check the selected source, branch and audience. Add factual project context and refine the outline with specific task descriptions. If the source does not establish a feature, adding its name to the outline does not make it documented behavior.

Some pages are incomplete or failed

Wait for the current processing state to settle and inspect the affected pages. Use the retry or recovery action offered for that run when available. Avoid creating multiple duplicate full runs while the original is still active.

If a retry is unavailable or fails again, contact support with the Space name, page titles, approximate time and visible error. Do not delete the Space before support can identify the affected work.

Generation is unavailable

Check credits and usage, your plan and team role. Viewers cannot start generation. A team member may need the owner's help with entitlement or available credits.

The content needs improvement

Edit small corrections directly. For missing topics or a deliberate reorganization, use Update Documentation Gaps. For future runs, improve the source selection, audience and AI preferences.

Review output for correctness before publishing; finishing a generation confirms that content was produced, not that every statement has been independently validated.