Update share datasets (#225)

Author: tothmano

doc-assets/icons/change-data-retention.svg

@@ -245,7 +245,6 @@
                   "reference/introduction",
                   "reference/cli",
                   "reference/datasets",
-                  "reference/sharing",
                   "reference/query-hours"
                 ]
               },
@@ -828,6 +827,10 @@
     {
       "source": "/reference/eu-domain",
       "destination": "/reference/regions"
+    },
+    {
+      "source": "/reference/sharing",
+      "destination": "/reference/datasets"
     }
   ]
 }

doc-assets/icons/share-dataset.svg

@@ -28,4 +28,6 @@ Current private preview features:
 
 Current public preview features:
 - [Cursor-based pagination](/restapi/pagination)
-- [Send data from Next.js app to Axiom using axiom-nextjs library](/send-data/nextjs)
+- [Send data from JavaScript app to Axiom using @axiomhq/logging library](/guides/javascript)
+- [Send data from Next.js app to Axiom using @axiomhq/nextjs library](/send-data/nextjs)
+- [Send data from React app to Axiom using @axiomhq/react library](/send-data/react)

docs.json

@@ -95,10 +95,9 @@ You can import data to your dataset in one of the following formats:
 To import data to a dataset, follow these steps:
 
 1. Click <img src="/doc-assets/icons/settings.svg" className="inline-icon" alt="Settings icon" /> **Settings > Datasets**.
-2. In the list, click the dataset where you want to import data.
-3. Click <img src="/doc-assets/icons/import.svg" className="inline-icon" alt="Import icon" /> **Import**.
-4. Optional: Specify the timestamp field. This is only necessary if your data contains a timestamp field and it’s different from `_time`.
-5. Upload the file, and then click **Import**.
+1. In the list, find the dataset where you want to import data, and then click <img src="/doc-assets/icons/import.svg" className="inline-icon" alt="Import icon" /> **Import** on the right.
+1. Optional: Specify the timestamp field. This is only necessary if your data contains a timestamp field and it’s different from `_time`.
+1. Upload the file, and then click **Import**.
 
 ## Trim dataset
 
@@ -111,10 +110,9 @@ Trimming a dataset deletes all data before the specified date.
 To trim a dataset, follow these steps:
 
 1. Click <img src="/doc-assets/icons/settings.svg" className="inline-icon" alt="Settings icon" /> **Settings > Datasets**.
-2. In the list, click the dataset that you want to trim.
-3. Click <img src="/doc-assets/icons/trim.svg" className="inline-icon" alt="Trim dataset icon" /> **Trim dataset**.
-4. Specify the date before which you want to delete data.
-5. Enter the name of the dataset, and then click **Trim**.
+1. In the list, find the dataset that you want to trim, and then click <img src="/doc-assets/icons/trim.svg" className="inline-icon" alt="Trim dataset icon" /> **Trim dataset** on the right.
+1. Specify the date before which you want to delete data.
+1. Enter the name of the dataset, and then click **Trim**.
 
 ## Vacuum fields
 
@@ -131,22 +129,61 @@ You can only vacuum fields once per day for each dataset.
 To vacuum fields, follow these steps:
 
 1. Click <img src="/doc-assets/icons/settings.svg" className="inline-icon" alt="Settings icon" /> **Settings > Datasets**.
-2. In the list, click the dataset where you want to vacuum fields.
-3. Click <img src="/doc-assets/icons/vacuum.svg" className="inline-icon" alt="Vacuum fields icon" /> **Vacuum fields**.
-4. Select the checkbox, and then click **Vacuum**.
+1. In the list, find the dataset where you want to vacuum fields, and then click <img src="/doc-assets/icons/vacuum.svg" className="inline-icon" alt="Vacuum fields icon" /> **Vacuum fields** on the right.
+1. Select the checkbox, and then click **Vacuum**.
 
-## Delete dataset
+## Share datasets
 
-<Warning>
-Deleting a dataset deletes all data contained in the dataset.
-</Warning>
+You can share your datasets with other Axiom organizations. The receiving organization:
 
-To delete a dataset, follow these steps:
+- can query the shared dataset.
+- can create other Axiom resources that rely on query access such as dashboards and monitors.
+- can’t ingest data into the shared dataset.
+- can‘t modify the shared dataset.
 
+No ingest usage associated with the shared dataset accrues to the receiving organization. Query usage associated with the shared dataset accrues to the organization running the query.  
+
+To share a dataset with another Axiom organization:
+
+1. Ensure you have the necessary privileges to share datasets. By default, only users with the Owner role can share datasets.
 1. Click <img src="/doc-assets/icons/settings.svg" className="inline-icon" alt="Settings icon" /> **Settings > Datasets**.
-2. In the list, click the dataset that you want to delete.
-3. Click <img src="/doc-assets/icons/import.svg" className="inline-icon" alt="Delete dataset icon" /> **Delete dataset**.
-4. Enter the name of the dataset, and then click **Delete**.
+1. In the list, find the dataset that you want to share, and then click <img src="/doc-assets/icons/share-dataset.svg" className="inline-icon" alt="Share dataset icon" /> **Share dataset** on the right.
+1. In the Sharing links section, click **+** to create a new sharing link.
+1. Copy the URL and share it with the receiving user in the organization with which you want to share the dataset. For example, `https://app.axiom.co/s/dataset/{sharing-token}`.
+1. Ask the receiving user to open the sharing link. When opening the link, the receiving user sees the name of the dataset and the email address of the Axiom user that created the sharing link. They click **Add dataset** to confirm that they want to receive the shared dataset.
+
+### Delete sharing link
+
+Organizations can gain access to the dataset with an active sharing link. To deactivate the sharing link, delete the sharing link. Deleting a sharing link means that organizations that don’t have access to the dataset can’t use the sharing link to join the dataset in the future. Deleting a sharing link doesn’t affect the access of organizations that already have access to the shared dataset.
+
+To delete a sharing link:
+
+1. Click <img src="/doc-assets/icons/settings.svg" className="inline-icon" alt="Settings icon" /> **Settings > Datasets**.
+1. In the list, find the dataset, and then click <img src="/doc-assets/icons/share-dataset.svg" className="inline-icon" alt="Share dataset icon" /> **Share dataset** on the right.
+1. To the right of the sharing link, click <img src="/doc-assets/icons/delete.svg" className="inline-icon" alt="Delete icon" /> **Delete**.
+1. Click **Delete sharing link**.
+
+### Remove access to shared dataset
+
+If your organization has previously shared a dataset with a receiving organization, and you want to remove the receiving organization’s access to the dataset, follow these steps:
+
+1. Click <img src="/doc-assets/icons/settings.svg" className="inline-icon" alt="Settings icon" /> **Settings > Datasets**.
+1. In the list, find the dataset, and then click <img src="/doc-assets/icons/share-dataset.svg" className="inline-icon" alt="Share dataset icon" /> **Share dataset** on the right.
+1. In the list, find the organization whose access you want to remove, and then click <img src="/doc-assets/icons/delete.svg" className="inline-icon" alt="Delete icon" /> **Remove**.
+1. Click **Remove access**.
+
+### Remove shared dataset
+
+If your organization has previously received access to a dataset from a sending organization, and you want to remove the shared dataset from your organization, follow these steps:
+
+1. Ensure you have Delete permissions for the shared dataset.
+1. Click <img src="/doc-assets/icons/settings.svg" className="inline-icon" alt="Settings icon" /> **Settings > Datasets**.
+1. In the list, click the shared dataset that you want to remove, and then click <img src="/doc-assets/icons/delete.svg" className="inline-icon" alt="Delete dataset icon" /> **Remove dataset**.
+1. Enter the name of the dataset, and then click **Remove**.
+
+<Note>
+This procedure only removes the shared dataset from your organization. The underlying dataset in the sending organization isn’t affected.
+</Note>
 
 ## Change data retention period
 
@@ -161,7 +198,18 @@ When you change the data retention period for a dataset, all data older than the
 To change the data retention period for a dataset, follow these steps:
 
 1. Click <img src="/doc-assets/icons/settings.svg" className="inline-icon" alt="Settings icon" /> **Settings > Datasets**.
-1. In the list, click the dataset for which you want to change the retention period.
-1. Click <img src="/doc-assets/icons/hard-drive.svg" className="inline-icon" alt="Hard drive icon" /> **Edit dataset retention**.
+1. In the list, find the dataset for which you want to change the retention period, and then click <img src="/doc-assets/icons/change-data-retention.svg" className="inline-icon" alt="Edit dataset retention icon" /> **Edit dataset retention** on the right.
 1. Enter a data retention period. The custom retention period must be greater than 0 days and less than the default defined by your pricing plan.
-1. Click **Submit**.
+1. Click **Submit**.
+
+## Delete dataset
+
+<Warning>
+Deleting a dataset deletes all data contained in the dataset.
+</Warning>
+
+To delete a dataset, follow these steps:
+
+1. Click <img src="/doc-assets/icons/settings.svg" className="inline-icon" alt="Settings icon" /> **Settings > Datasets**.
+1. In the list, click the dataset that you want to delete, and then click <img src="/doc-assets/icons/delete.svg" className="inline-icon" alt="Delete dataset icon" /> **Delete dataset**.
+1. Enter the name of the dataset, and then click **Delete**.