# Editing

Look for content that can be shortened, clarified, or even deleted.

### Check user focus

* [ ] Who is the user?
* [ ] What do they want to do? (one thing per page)
* [ ] When is it done?

### Check task direction

* [ ] Does the first sentence explain what the service does?
* [ ] Does each sentence help the user with the task?

### Shorten content

* [ ] Sentences should be under 15 words.
* [ ] Paragraphs should have 3 sentences or less.
* [ ] Write subheadings about every 3 paragraphs.
* [ ] Use bulleted lists instead of long sentence lists.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://sfdigitalservices.gitbook.io/style-guide/editing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
