FAQ
Does DraftStack publish docs automatically?
Section titled “Does DraftStack publish docs automatically?”By default, no. DraftStack creates suggestions for review, and approving a suggestion opens a draft GitHub pull request in the documentation repository. Two opt-in settings remove the manual steps: --pr-mode auto merges the pull request immediately on approval, and a project auto-approval threshold publishes high-confidence suggestions with no reviewer at all. Together they form a fully hands-off pipeline; projects that set neither always keep a human review gate.
Which repositories does DraftStack change?
Section titled “Which repositories does DraftStack change?”DraftStack writes only to the documentation repository. It reads from the monitored source repositories and never writes to them.
What triggers a suggestion?
Section titled “What triggers a suggestion?”Most suggestions come from merged pull requests on monitored repositories. DraftStack also analyzes direct pushes to branches, manual requests, backfilled history, and scheduled audit sweeps. Every source runs through the same analysis, so a suggestion only appears when the change affects readers.
Can I use DraftStack from the terminal?
Section titled “Can I use DraftStack from the terminal?”Yes. The CLI uses the same hosted API as the dashboard. See the CLI reference.