# Common ways to improve content readability for AI

Improving readability is one of the fastest ways to enhance your content's performance. Here are some common and effective strategies:

* **Write Shorter Sentences:** Break up long, complex sentences into two or three shorter ones.
* **Use Simpler Paragraphs:** Keep paragraphs focused on a single idea and limit them to 3-4 sentences.
* **Prefer the Active Voice:** Write in a direct, active voice whenever possible to make it clear who is performing the action.
* **Use Headings and Subheadings:** A strong heading structure (H1, H2, H3) creates a clear hierarchy and acts as a roadmap for AI crawlers.
* **Utilize Lists and Bullet Points:** For processes, features, or key takeaways, use numbered lists or bullet points. This structured format is exceptionally easy for AI to ingest and repurpose in its answers.
* **Avoid Jargon or Define It:** If you must use industry-specific terms, provide a clear, simple definition immediately. This helps the AI (and your human audience) learn.


---

# 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://flensh.gitbook.io/flensh-docs/core-features-in-detail/2.5.-the-real-time-readability-analyzer/common-ways-to-improve-content-readability-for-ai.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.
