# Docs

### Introduction

Docs in Motion aren’t just places to write, they’re where ideas turn into action. With AI built into Docs, you can draft from scratch, refine sections inline, pull in references, and even get critiques; all without leaving your doc. Instead of switching between writing and planning tools, Motion keeps everything connected: your tasks, projects, and documents live side by side.

#### At a Glance

* Start from a **blank doc** or ask AI to draft for you.
* Add **references** like brand guides, docs, or project links for context-rich drafts.
* **Tweak sections inline** with AI-powered skills like Summarize or Rewrite.
* Get **critiques** from role-based perspectives to sharpen your doc.
* Use **version history** to roll back changes anytime.

#### What You’ll Learn

By the end of this guide, you’ll know how to:

1. Start a draft from a blank doc and let AI handle the first pass.
2. Add references so your doc matches your brand, tone, or context.
3. Edit inline with AI tools that rewrite, summarize, or refine sections.
4. Request critiques and apply actionable feedback.
5. Roll back AI changes with version snapshots for peace of mind.

***

### Start a blank doc

<details>

<summary>Start a Draft from a Blank Doc</summary>

Every great doc starts with… well, a blank page. But in Motion, that page comes with AI on standby, ready to draft for you.

1. **Open a new doc**
   1. From the sidebar, click **+ New → New Doc**.
   2. Or open an existing folder/workspace and hit **+ → New Doc**.
2. **Choose how to start**
   1. On the blank page, start typing your content.
   2. Or use **Docs AI**, describe what you want to draft.
3. **Tell Motion what you need**
   1. Type a prompt like: *“Write a marketing launch plan for the summer. I am an retail e-commerce store."*
   2. If prompted, answer 2–3 clarifying questions (e.g., audience, timeline, goals).
4. **Sit back and watch**&#x20;
   1. Motion begins streaming a draft directly into your doc.
   2. The doc locks while AI writes, so everything stays tidy.
   3. A version snapshot is created automatically in case you want to roll back.

</details>

{% @supademo/embed demoId="cmkmr961p237p12fiax85b37m" url="<https://app.supademo.com/demo/cmkmr961p237p12fiax85b37m>" %}

### Adding references

<details>

<summary>Add References for Smarter Drafts</summary>

Motion AI gets even better when you give it context. By adding references, you help Motion mirror the tone, style, or details from your existing work. Think of it as handing your AI co-writer a stack of notes before they start typing.

1. **Open the AI chat**
   1. At the bottom of your doc, click into the chat bar.
2. **Attach references**
   1. Use **@mention** to link existing docs, tasks, or projects.
3. **Guide Motion on how to use them**
   1. Example: *“Follow tone in the brand guide and pull deadlines from the Q4 project plan.”*
4. **Confirm and run**
   1. Your references will appear in the chat and stay tied to this doc for future prompts.

{% hint style="info" %}
💡 **Pro tip:** Think of references as your “AI guardrails.” The clearer the sources, the closer your draft will land to what you’d write yourself.
{% endhint %}

</details>

{% @supademo/embed demoId="cmkmrhijd23p612fiaqwx2kdc" url="<https://app.supademo.com/demo/cmkmrhijd23p612fiaqwx2kdc>" %}

### Tweak sections inline

<details>

<summary>Tweak Any Section Inline</summary>

Sometimes a draft is close, but not quite there. Instead of rewriting everything, you can refine any part of your doc directly — no messy copy-paste.

1. **Highlight the section** you want to update.
2. On the block toolbar, click **AI tools**.
3. Choose a skill like **Summarize**, **Rewrite or edit text**, **create a task, or create multiple tasks.**
4. Review the changes inline. Approve them or keep iterating with AI in the chat.

{% hint style="info" %}
💡 **Pro tip:** Use small, specific prompts (e.g., *“Rewrite to be more persuasive”*). Targeted asks = sharper results.
{% endhint %}

</details>

{% @supademo/embed demoId="cmkmropzt249y12fibupfs2ij" url="<https://app.supademo.com/demo/cmkmropzt249y12fibupfs2ij>" %}

### Get a quick critique&#x20;

<details>

<summary>Get a Quick Critique</summary>

Think of this as having an editor on standby. Motion can review your doc and give you actionable, role-based feedback in seconds.

1. Open the **AI chat** in your doc.
2. Type **Provide feedback on this document** as the prompt.
3. Review the notes (e.g., “B2B marketer feedback” or “General clarity improvements”).
4. If you agree, click **Apply suggested changes** to implement them instantly.

{% hint style="info" %}
💡 **Pro tip:** Try feedback from different roles (like “marketer” vs “project manager”) to see your doc through multiple lenses.
{% endhint %}

</details>

{% @supademo/embed demoId="cmkmrvavs24sl12fiwpbeuf10" url="<https://app.supademo.com/demo/cmkmrvavs24sl12fiwpbeuf10>" %}

### Accessing version history

<details>

<summary>Roll Back Any AI Change</summary>

Made an edit you’re not happy with? No problem, Motion automatically saves version snapshots every time you or AI makes a change. You can roll back in seconds.

1. Go to the **top right corner** of your doc and click the **version history icon** (the clock with an arrow).&#x20;
2. In the panel, browse through your saved snapshots. Each one is timestamped with who made the change.
3. Click **Restore** on the version you’d like to return to.

{% hint style="info" %}
💡 **Pro tip:** Use version history not just as an undo button, but as a way to track how your draft evolved over time.
{% endhint %}

</details>

{% @supademo/embed demoId="cmkms0i7r250w12fi1zw419b2" url="<https://app.supademo.com/demo/cmkms0i7r250w12fi1zw419b2>" %}


---

# 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://www.usemotion.com/help/knowledge-management/docs.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.