From d5908709fadd287ac427bcd3cd7fbbd25ed18610 Mon Sep 17 00:00:00 2001
From: Jared Scott <jared.scott@datarecce.io>
Date: Tue, 27 May 2025 11:00:10 +0800
Subject: [PATCH] feat: drc-1329

Cleanup share-recce-session-securely.md docs
- Make it easier to link to each specific section.
- Add info and note sections to break up the document into consumable chunks

Signed-off-by: Jared Scott <jared.scott@datarecce.io>
---
 .idea/recce-docs.iml                          |  2 +
 .../share-recce-session-securely.md           | 72 +++++++++----------
 2 files changed, 37 insertions(+), 37 deletions(-)

diff --git a/.idea/recce-docs.iml b/.idea/recce-docs.iml
index 16c4783..8b1a6c3 100644
--- a/.idea/recce-docs.iml
+++ b/.idea/recce-docs.iml
@@ -11,6 +11,8 @@
       <excludeFolder url="file://$MODULE_DIR$/.venv" />
       <excludeFolder url="file://$MODULE_DIR$/temp" />
       <excludeFolder url="file://$MODULE_DIR$/tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/.cache" />
+      <excludeFolder url="file://$MODULE_DIR$/site" />
     </content>
     <orderEntry type="inheritedJdk" />
     <orderEntry type="sourceFolder" forTests="false" />
diff --git a/docs/recce-cloud/share-recce-session-securely.md b/docs/recce-cloud/share-recce-session-securely.md
index afb6ccc..cf13db0 100644
--- a/docs/recce-cloud/share-recce-session-securely.md
+++ b/docs/recce-cloud/share-recce-session-securely.md
@@ -19,59 +19,57 @@ When you're ready to share your lineage exploration, query results, or validatio
 
 The first time you do this, you'll need to connect your local Recce to Recce Cloud. This requires signing in and setting up an API token. Once connected, Recce Cloud will host your state file securely, allowing you to share a link that others can open in their browsers.
 
-1. Enable Recce Sharing
+### 1. Enable Recce Sharing
 
-    To start sharing, launch Recce server and click the **Enable Sharing** button.
+To start sharing, launch Recce server and click the **Enable Sharing** button.
 
-    ![Recce Server](../assets/images/recce-cloud/recce-server-enable-sharing-fs8.png){: .shadow}
+![Recce Server](../assets/images/recce-cloud/recce-server-enable-sharing-fs8.png){: .shadow}
 
-1. Sign in to Recce Cloud and get your API token
+### 2. Sign in to Recce Cloud and retrieve your API token
 
-    Copy your API token from the [personal settings page](https://cloud.datarecce.io/settings#tokens) in Recce Cloud.
+Copy your API token from the [personal settings page](https://cloud.datarecce.io/settings#tokens) in Recce Cloud.
 
-    ![Recce API Token](../assets/images/recce-cloud/setting-page-api-token-fs8.png){: .shadow}
+![Recce API Token](../assets/images/recce-cloud/setting-page-api-token-fs8.png){: .shadow}
 
-1. Add the token to `.recce/profile.yml`
+### 3. Add the token to `.recce/profile.yml`
 
-    For convenience, you can add your API token in `.recce/profile.yml`, located in your home directory.
+For convenience, you can add your API token in `.recce/profile.yml`, located in your home directory.
 
-    - Find the `.recce` folder in your home directory.
+- Find the `.recce` folder in your home directory.
 
-        **For Mac/Linux users:**
-
-        In the terminal, type the following command to navigate to the Recce configuration directory:
-        ```shell
-        cd ~/.recce
-        ```
-
-        **For Windows users:**
+!!! info
+    **For Mac/Linux users:** In the terminal, type the following command to navigate to the Recce configuration directory:
+    ```shell
+    cd ~/.recce
+    ```
+    **For Windows users:** Navigate to `C:\Users\<your_user_name>` and open the hidden `.recce` folder.
 
-        Navigate to `C:\Users\<your_user_name>` and open the hidden `.recce` folder.
+    Or in PowerShell, type:
+    ```powershell
+    cd ~\.recce
+    ```
 
-        Or in PowerShell, type:
-        ```powershell
-        cd ~\.recce
-        ```
+- Open `profile.yml` with any text editor to add your token:
+```yaml
+api_token: <your_api_token>
+```
 
-    - Open `profile.yml` with any text editor to add your token:
-    ```yaml
-    api_token: <your_api_token>
-    ```
-    Alternatively, for one-time use, you can use `--api-token` flag with commend. e.g.,
+!!! note
+    Alternatively, for one-time use, you can use `--api-token` flag with the following command:
     ```bash
     recce server --api-token <your_api_token>
     ```
 
-1. Relaunch Recce server
+### 4. Relaunch Recce server
 
-    After adding the API token, restarting Recce server is required to load the new configuration.
-    Once it's running, you'll see the **Share** button, then you can click it to get the link on top.
+After adding the API token, restarting Recce server is required to load the new configuration.
+Once it's running, you'll see the **Share** button, then you can click it to get the link on top.
 
-    ![Recce Share From Server](../assets/images/recce-cloud/recce-share-from-server-fs8.png){: .shadow}
+![Recce Share From Server](../assets/images/recce-cloud/recce-share-from-server-fs8.png){: .shadow}
 
-    You can also use the `recce share` command. If you already have a prepared Recce state file, you can obtain a share link directly through the command line.
-    ```bash
-    recce share <your_state_file>
-    recce share --api-token <your_api_token> <your_state_file>  # for one-time use
-    ```
-    ![Recce Share From CLI](../assets/images/recce-cloud/recce-share-from-cli.png){: .shadow}
+You can also use the `recce share` command. If you already have a prepared Recce state file, you can obtain a share link directly through the command line.
+```bash
+recce share <your_state_file>
+recce share --api-token <your_api_token> <your_state_file>  # for one-time use
+```
+![Recce Share From CLI](../assets/images/recce-cloud/recce-share-from-cli.png){: .shadow}