Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

docs - updates on documents, comments, and Metabot (#63922)

Jeff Bruemmer45d701fd6b7a
diff --git a/docs/ai/metabot.md b/docs/ai/metabot.md
index d1e637329f8..9403432e482 100644
--- a/docs/ai/metabot.md
+++ b/docs/ai/metabot.md
@@ -83,7 +83,7 @@ To have Metabot generate SQL for you:
3. Type cmd+b on Mac, ctrl+b on Windows, to open up the [chat sidebar](#the-metabot-chat-sidebar).
4. Ask it to "Write a SQL query that..." and type your prompt.
-Metabot will generate the SQL for you, but it won't run the query. This gives you a chance to inspect the code before running it. The native editor is designed to be read-only (so don't worry about Metabot dropping any tables), but you should still check the query to make sure it targets the data you want.
+Metabot will generate the SQL for you, but it won't run the query. This gives you a chance to inspect the code before running it.
If you don't specify a specific table in a natural language question, Metabot will only check the first 100 tables in the currently selected database. If your question pertains to tables other than those first 100 tables, Metabot may hallucinate the tables it needs, and the query will fail.
diff --git a/docs/documents/images/document-with-comment.png b/docs/documents/images/document-with-comment.png
new file mode 100644
index 00000000000..97a4599bdaa
Binary files /dev/null and b/docs/documents/images/document-with-comment.png differ
diff --git a/docs/documents/introduction.md b/docs/documents/introduction.md
index 42378631a89..20ecce624e0 100644
--- a/docs/documents/introduction.md
+++ b/docs/documents/introduction.md
@@ -7,6 +7,8 @@ summary: Create documents to combine text and charts for long-form analysis. Add
{% include plans-blockquote.html feature="Documents" %}
+![Document with comment](./images/document-with-comment.png)
+
Documents let you tell a story with your data by combining text, charts, and other content.
## Create a document
@@ -34,7 +36,9 @@ You can add [questions](../questions/start.md) and [models](../data-modeling/mod
### Adding a chart copies it to the document
-When you add a chart from a collection, Metabase creates a copy in the document. The original question remains in the collection.
+When 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).
### Charts generated by Metabot only exist in the document
@@ -74,9 +78,14 @@ You can comment on whole sections like charts, headings, or text blocks. You can
You can:
- React to comments with emojis (which are like pictures masquerading as words). For example, this is a gondola: 🚠.
+- Mention other items or people in your Metabase (type `@` and then search for who/what you want to mention).
- Link to a comment. Click the **three-dot** menu and select **Copy link**.
- Resolve comments. Resolved comments appear in a separate tab.
+### Comment notifications
+
+If someone mentions you in a thread, or responds to a comment in a thread you're in, Metabase will send you an email to let you know. Currently, there's no central place to view all of your threads and mentions, and no way to disable email notifications for comments.
+
### Deleting comments
If you never want to see a comment again:
@@ -86,7 +95,7 @@ If you never want to see a comment again:
3. Click on the **three-dot** menu.
4. Select **Delete**.
-This deletion is permanent. You'll never see that comment again.
+This deletion is permanent.
## Printing documents
@@ -101,7 +110,6 @@ Documents and dashboards both have their use cases.
Documents work best for:
- Telling a story with data
-- Point-in-time analysis
- Opening analysis for comments
- Exploratory analysis
diff --git a/docs/people-and-groups/account-settings.md b/docs/people-and-groups/account-settings.md
index d7cf15b09b0..aa1241de070 100644
--- a/docs/people-and-groups/account-settings.md
+++ b/docs/people-and-groups/account-settings.md
@@ -1,5 +1,6 @@
---
title: Account settings
+summary: Update your profile, change your password, view login history, manage notifications, and customize your Metabase experience.
redirect_from:
- /docs/latest/users-guide/account-settings
---
@@ -34,3 +35,5 @@ This isn't an in-Metabase setting, but just so you know: you can disable UI anim
## Notifications
If you subscribe or are added to dashboard subscriptions or alerts, you’ll be able to manage those notifications here (as well as on the relevant question or dashboard themselves).
+
+Metabase excludes notificatione for [comments](../documents/introduction.md#comment-notifications) from this page.