> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dovetail.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Getting started with docs
## How to create a doc
You can create a doc as a shareable asset that summarizes key findings and takeaways from data from a project or channel.
**Docs** lets you generate, structure, and edit insights or reports using AI directly from chat or pre-defined frameworks. Whether you’re drafting a **Voice of Customer report**, **Product requirements document** , or **Feature request**, Docs helps you create a polished first draft in minutes.
To create an doc in a project:
* Select `+` and toggle `Doc` on.
* Next, select `Create AI Doc.`
* From there, choose how you want to create your insight. You can:
* Ask a question or write a custom prompt in chat (e.g. “Summarize key findings from customer interviews”), with the help of [AI docs (beta)](https://dovetail.com/settings/beta), or
* Select a predefined framework like Voice of Customer, Research Report, or PRD.
* To create an insight in a Channel, open a topic, click on a theme and select `New doc`.
* Next, select a pre-defined prompt with the help of [AI docs (beta)](https://dovetail.com/settings/beta) to automatically synthesize data points within the theme.
* From there, refine your insight. Add text, references, and use formatting and editing tools before sharing with your stakeholders. This insight will live inside `Your Work`.
To generate an insight from a folder, you’ll need the [Docs, anywhere beta enabled](https://dovetail.com/settings/beta). Docs (formerly insights) let you create a doc, equivalent to an insight, anywhere in Dovetail, including folders, making it easier to organize, share, and collaborate with your team.
If you want to create an doc that isn’t tied to a specific project or folder:
1. Go to the sidebar.
2. Select `+ New` and select `Doc`.
Or, if you want to create a doc from a specific folder:
* Go to the folder.
* click `New` and select `Doc`.
* To generate an AI doc, choose a framework or write your own prompt.
* To create a doc manually, simply start typing.
To create a doc from a chat response:
1. Find the most recent response in your chat
2. Click `Create doc from response` on that message
3. A new doc will be generated automatically from the content, including the formatting and references
All docs generated with AI will include an AI disclaimer.
***
## Add data to your doc
Add data to a doc from across your Dovetail workspace using the reference picker.
* To do this, open your doc and type`/`within the editor to see all available options.
* Using this menu, select `References`. You can search for and filter content by object type (highlights, tags, data, etc.) to select/drag and drop these directly into your doc.
* From there, you can customize how the highlight is presented by toggling on or off the content you want to display.
By default, references won’t show project name and creator information. Dovetail will remember your preferences for each subsequent reference that is added.
***
## Create a reel for your doc
You can create and embed a custom reel that stitches together key highlights created in your project. [Learn how to curate and edit a highlight reel in your doc →](https://docs.dovetail.com/help/projects/highlight-reels/)
***
## Generate a summary
Once data is added to your doc, provide a TL;DR of any long-form report with a magic summary of your doc. Doc summaries pull in information from any content added to a doc, including reels, highlights, data, text, and documents.
* To create a doc summary, open your doc (containing embedded data) and type `/` within the editor to see all available options.
* From there, select `Summarize` and a text summary card will be added at the top of your doc.
***
## Generate summary of survey results
When importing survey data into a project, Dovetail automatically creates a doc of the results. In this doc, you will see a breakdown of each question's results. If your original survey includes single or multi-select data types, you will also have the option to visualize each summary as a chart.
***
## Update project data on docs
Adding project data (data, highlights, tags, or docs) to a doc will create a point-in-time snapshot of the object so that it will remain unchanged if the underlying data is modified or deleted.
* To update a reference, you must have `Manager` or `Contributor` access with `Can edit` access to the project.
* From there, select `Update reference (↻)` while hovering over it. You can also update references in bulk by with `Update all` from within the doc's menu `•••` in the top right.
References to objects that have been deleted will be retained, and an alert will appear on the reference to notify users that the underlying object no longer exists.
References in dynamic feeds, such as search blocks, are live blocks that automatically update and will always display the most up-to-date version of any displayed references.
***
## Categorize docs with fields
You can organize and store structured information about and on your dics using fields. Fields help teams categorize findings and support the discovery of prior research in Dovetail. [Learn more about fields and how to use them for organizing your docs in the workspace →](https://docs.dovetail.com/help/projects/data-and-insight-fields/)
When a doc is published, empty fields will be hidden, making the insight cleaner and easier for your team to consume.
Fields are available in project docs only. If you’re working in a workspace doc, move it into a project to add fields.