Example prompts
Copy a ready-made prompt into Claude, ChatGPT or Cursor to build, update, translate and tidy your Sonat documentation.
Paste a prompt, replace the parts in [brackets], and send it. Your AI tool picks the Sonat tools it needs. Most tools ask you to approve each step before it runs, so read what it plans to do.
Build a manual
A full manual from a short brief
Create a new Sonat document called "[Product] User Guide" for [audience].
Plan an outline first and show it to me. After I approve it, add one topic per
section with complete content, then publish all the topics in one go and give
me the live links.
A manual from a web page you own
Read [https://your-site.com/product-page] and turn it into a Sonat document
called "[Title]". Use one topic per section, follow the how-to guide
guideline, and leave everything as drafts.
Release notes from a list of changes
Turn these changes into a new draft topic called "Release notes [version]"
in my "[Document name]" document. Group them under New, Improved and Fixed.
[paste your changes]
Update existing docs
Rewrite one topic
In my "[Document name]" document, find the topic "[Topic title]". Rewrite it
to be shorter and easier for beginners. Keep every step. Leave it as a draft
and tell me what you changed.
Apply a product change everywhere
We renamed "[old name]" to "[new name]". Search my Sonat docs for every topic
that mentions "[old name]", list them, and after I confirm, update each one.
Leave the changes as drafts.
Check a topic against the source
Compare the Sonat topic "[Topic title]" with [https://your-site.com/changelog].
List anything in the topic that is out of date, then update it as a draft.
Find and fill content gaps
These prompts read AI Insights, which is available on Team and above.
What should I write next?
Read my Sonat content gaps and the AI Insights overview for the last 30 days.
Group the unanswered questions by theme, say which ones look like missing
topics and which look like existing topics that need fixing, and rank them by
how often they failed.
Close the top gaps
Take the top 5 content gaps from the last 30 days. For each one, search my
docs first to make sure nothing already covers it. Draft a new topic for the
real gaps in "[Document name]", and suggest fixes for topics that exist but
answered badly. Don't publish.
Translate
Translate one topic
In my "[Document name]" document, read the English topic "[Topic title]" and
write a [French] version of the same topic. Keep headings, lists, links and
images. Leave it as a draft.
The document needs the target language before the AI can save a version in it. See Add languages. To translate whole documents, machine translation in the editor is usually faster.
Tidy your structure
Review a document's outline
Show me the full topic tree of "[Document name]", including drafts. Point out
topics that are duplicated, too long, or in the wrong place, and propose a
cleaner order. Don't change anything yet.
Reorganize after you approve
Apply the outline we agreed on: move the topics into that order and under the
right parents in "[Document name]". Then put the document in the
"[Folder name]" folder, creating the folder if it doesn't exist.
Built-in prompts
Sonat also gives your AI tool a few ready-made prompts. In Claude they appear in the prompt or attachment menu; other tools list them differently. The writing prompts appear only on Read & write connections.
| Prompt | What it does |
|---|---|
| Build a manual | Creates a complete multi-section manual on a subject you name and publishes it. |
| Draft a document from an outline | Creates a document with one published topic per outline item. |
| Answer from the knowledge base | Answers a question from your documentation, with links to the source topics. |
| Research a topic in the KB | Collects everything your documentation says about a subject and notes gaps. |
| Summarize a document | Writes a short summary and outline of a document. |
| Rewrite a topic | Rewrites a topic toward a goal you set and leaves it as a draft. |
Tips for better results
- Name the document and topic exactly as they appear in Sonat.
- Ask for an outline or a list first, then approve before the AI writes.
- Ask it to follow a Sonat writing guideline, such as the how-to guide, tutorial or troubleshooting guideline.
- Ask for one publish at the end rather than publishing as it goes.