Help with the words
Twelve actions on the text you selected. Nothing is applied by itself.
Help with the words
Section titled “Help with the words”Select text in the writer and ask for a suggestion. The suggestion appears as a diff you can edit. Nothing is written to the page until you accept it.
The twelve actions
Section titled “The twelve actions”| Action | What it does |
|---|---|
| Improve | Clearer wording. Every fact kept. |
| Shorten | Fewer words, same meaning. |
| Expand | More detail on what is already there. |
| Simplify | Plainer language. |
| Grammar | Grammar and punctuation only. |
| Example | Adds an example of what the text describes. |
| Tone | Rewrites to match your style guide. |
| Summarise | A short summary of the selection. |
| Outline | A heading structure for the topic. |
| Draft | A first draft from an instruction. |
| Explain | Explains a code block in prose. |
| Translate | One of twelve languages. |
Three rules it keeps
Section titled “Three rules it keeps”Your selection is the whole job. No other page, no page context, no repository is sent. Highlighting a paragraph is you saying what you want looked at, and nothing beyond it is sent to the provider.
Your glossary decides the words. The terms from
glossary.yaml that appear in your selection
travel with the request. An assistant that rewrites “workspace” to
“organisation” makes the documentation worse in exactly the way a glossary exists
to prevent.
The answer is text, not chat. A preamble such as “Here is an improved version:” is forbidden in the instruction and stripped from the result.
Selection size
Section titled “Selection size”Between 8 and 6000 characters. Below the minimum there is nothing to work on. Above the maximum, select less: a whole page is not one editing decision.
Translation
Section titled “Translation”Twelve languages: Arabic, Simplified Chinese, Dutch, French, German, Hindi, Italian, Japanese, Korean, Brazilian Portuguese, Spanish, Turkish.
Warning
A translation is a machine draft. Mark the page ai_draft: true until somebody
who reads the language has read it.
Allowance
Section titled “Allowance”Every action is a paid model call, counted against your plan’s daily allowance, per person and per project. See Limits.
What it never does
Section titled “What it never does”It does not publish. It does not edit a page you are not looking at. It does not
read your other pages. A page substantially drafted this way should carry
ai_draft: true until a person reviews it.