The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:
TypeScript analyticsbibusiness-intelligencebusinessintelligenceclojuredashboarddatadata-analysisdata-visualizationdatabasemetabasemysqlpostgrespostgresqlreportingslacksql-editorvisualization
docs - document links new charts (#65828)
Jeff Bruemmer9cd92bf39c36
diff --git a/docs/documents/introduction.md b/docs/documents/introduction.mdindex 218f530ef69..128406ce800 100644--- a/docs/documents/introduction.md+++ b/docs/documents/introduction.md@@ -23,26 +23,42 @@ Documents let you tell a story with your data by combining text, charts, and othType `/` in your document to see available commands:- **Ask Metabot** to chat with [Metabot](../ai/metabot.md) in the document.-- **Chart** to insert a table or chart from an existing question or model. You can't add dashboards or other documents, but you can mention them (see the next section).-- **Link**. You can mention other items in your Metabase.+- **Chart** to insert a table or chart from an existing question or model, or create a new question directly in the document. You can't add dashboards or other documents, but you can mention them (see the next section).+- **Link** to mention other items in your Metabase.## Mention items with `@`-You can type `@` to mention items from your Metabase. (The mentions get a fancy little icon next to them).+You can type `@` to mention items from your Metabase (mentions get a fancy little icon next to them).## Add charts to documents-You can add [questions](../questions/start.md) and [models](../data-modeling/models.md) to a document.+You can add [questions](../questions/start.md) and [models](../data-modeling/models.md) to a document. You can either insert existing questions from your collections or create new questions directly in the document.++### Creating new questions in documents++To create a new question directly in a document:++1. Type `/` to open the command menu.+2. Select **Chart**.+3. Select **New chart**.+4. Choose either:+ - **New Question** to use the [query builder](../questions/query-builder/editor.md).+ - **New SQL query** to use the [native SQL editor](../questions/native-editor/writing-sql.md).+5. Build your question and click **Save and use** to add it to the document.++Questions created this way are saved directly to the document and don't appear in your collections unless you explicitly save them there later. Deleting charts made in documents is permanent. You can't recover deleted charts from the [trash](../exploration-and-organization/delete-and-restore.md).++To enter the full-screen editor for a question, click on the question's title.### Adding a chart copies it to the documentWhen you add a chart from a collection, Metabase creates a copy in the document. The original question remains in the collection. Changes to one copy won't affect the other; they're independent.-If however, you delete the document's copy, that copy is permanently deleted. It can't be recovered from the [trash](../exploration-and-organization/delete-and-restore.md).+If you delete the document's copy, that copy is permanently deleted and can't be recovered from the [trash](../exploration-and-organization/delete-and-restore.md).-### Charts generated by Metabot only exist in the document+### Charts created in documents only exist in the document-If [Metabot](../ai/metabot.md) generates a chart, Metabase saves that question to the document itself. If you delete it, it's gone forever. You won't be able to recover the question from the trash.+Questions that are created directly in the document (either through [Metabot](../ai/metabot.md) or by creating a new question via the Chart command) are saved to the document itself and don't appear in your collections. If you delete these questions from the document, they're permanently deleted and can't be recovered from the trash.## Editing charts@@ -61,7 +77,7 @@ Edits only affect the chart in the document. If you added the chart from a colleTo rearrange charts, simply click and hold on the chart and drag it to where you want it in the document.-You can put up to three charts side by side (more than three charts side-by-side gets crowded). To resize charts, you can click on the edges to adjust their size.+You can put up to three charts side by side (more than three charts side-by-side gets crowded). To resize charts, you can click on the edges to adjust their size.When there are multiple charts in the same row, you can resize them horizontally by clicking between the charts and sliding left or right to resize.@@ -84,7 +100,22 @@ You can also access formatting options by typing `/`.## Links-If you paste a link into a document, Metabase will turn it into a clickable link. For now, Markdown links aren't supported, and you can't change the link text.+You can add links to documents in several ways:++- **Select text and add a link**: Select any text, then click the **Link** button in the formatting menu. Enter a URL and press Enter.+- **Paste a URL**: Paste a link into a document, and Metabase will turn it into a clickable link.+- **Use Markdown syntax**: Type a link using Markdown format: `[link text](url)`. When you type the closing parenthesis, Metabase will convert it to a clickable link.++### Editing links++To edit a link:++1. Hover over the link.+2. Click the **pencil icon** in the popup.+3. Update the URL.+4. Click the **check icon** to save, or the **trash icon** to remove the link entirely.++To edit the link's visible text, edit the text in the document itself.## Commenting on documents@@ -118,7 +149,7 @@ If you never want to see a comment again:3. Click on the **three-dot** menu.4. Select **Delete**.-This deletion is permanent.+This deletion is permanent.## Printing documents