docs: made some iteration

Author: edeediong

docs/configuration/runme-gist.md

@@ -3,50 +3,57 @@ sidebar_position: 4
 title: Runme Gist
 ---
 
-Runme Gist
 Would you love to share or store your plain texts or code snippets securely with others in your team without needing a full repository or document?
-
-Runme Gist makes that possible and prioritizes your information's sensitivity by keeping sensitive information secret. In this section, we will explain how Runme Gist works.
+Runme Gist makes this possible and prioritizes your information's sensitivity by keeping sensitive information secret. In this section, we will explain how Runme Gist works.
 
 ## **What is Runme Gist?**
-Runme Gist combines GitHub Gist with Runme capabilities to run, share, and store plain texts or code snippets in your Markdown file. What makes Runme Gist so powerful is its ability to capture outputs and mask sensitive data without copying and pasting or integrating a third-party tool. You have everything done inside your Markdown file. Amazing right?
+Runme Gist combines GitHub Gist with Runme capabilities to run, share, and store plain texts or code snippets in your Markdown file. What makes Runme Gist powerful is its ability to capture outputs and mask sensitive data without copying and pasting or integrating a third-party tool. You have everything done inside your Markdown file. Amazing right?
 
 ## **Installation**
+
 - To utilize the Runme Gist feature, ensure the [Runme extension](../installation/installrunme) is installed in your VS Code. If you already have Runme installed in your VS Code, ensure you are upgraded to v3.4.0.
-- Make Runme your [default Markdown viewer](../installation/installrunme) to ensure all Markdown files are automatically opened as a Runme notebook.
+- Set Runme as your [default Markdown viewer](../installation/installrunme) to ensure all Markdown files in your code editor are automatically opened as a Runme notebook.
+
 
-## **How Runme Gist Works**
-As stated earlier, Runme Gist combines GitHub Gist with Runme capabilities to enable you to securely run, share, and store code snippets. In this section, we will explain how Runme Gist works.
+## **Setting Up Runme Gist **
+As stated earlier, Runme Gist combines GitHub Gist with Runme capabilities to enable you to securely run, share, and store code snippets. In this section, we will explain how Runme Gist works using a step-by-step guide.
 
 1. Open your Markdown File
-Create a Readme.md file and open it in your VS Code. If you already have the file you want to use, open it in VS Code.
+Create a `Readme.md` file and open it in your VS Code. If you already have the file you want to use, open it in VS Code.
 2. Run Cells
-Run your notebook cells, and ensure the auto-save feature is turned on to save your outputs without manual intervention.
+Run your notebook cells, and ensure the [auto-save feature](../configuration/auto-save) is turned on to save your outputs without manual intervention.
 
 ![runme gist Autosave ](../../static/img/configuration-page/runme-gist-autosave.png)
 
 3. View Sessions Output
+Session output is a Runme feature that stores your generated cell outputs to a separate file to enable you access the output whenever you need. See the [Session output](../configuration/auto-save#session-outputs) guide.
+
 To view your session output, click “Sessions Outputs” to inspect the locally recorded session. Alternatively, you can find it on the left-hand side of your VS Code right inside your current working directory.
 
 ![Runme gist session output](../../static/img/configuration-page/runme-gist-sessionoutput.png)
 
-The Session Outputs feature only appears when the autosave is activated and the Runme cell is run.
+The Session Outputs feature is only available when the autosave is activated and the Runme cell is run.
 
 4. Toggle Between Mask and Unmask
 You can decide if you want your session outputs to be masked or unmasked.
+The masked and unmasked options are how Runme keeps your sensitive information secret. If you want to keep your sensitive information secret, you should toggle the mask option otherwise, choose the unmasked option.
 By default, Runme uses the open-source data guardian to mask sensitive information on a best-effort basis.
 
+
 ![Runme gist unmask](../../static/img/configuration-page/runme-gist-unmask.png)
 
-## **Creating and Managing gist With Runme**
+## **Creating and Managing Gist with Runme using “Secret Gists”**
 
 GitHub Gist is a service provided by GitHub that allows users to share code snippets, notes, and other small pieces of text with others. With a single click, you can push your Runme Session Output to GitHub Gist from your Markdown file.
 To do this, click on “Generate Gist”.
 
 ![Runme gist](../../static/img/configuration-page/runme-gist.png)
 
-Runme will first prompt you to log into your GitHub account and grant write access to your Gist. After a successful login, it will display a notification containing a link to the Runme Gist hosted on your GitHub.
-The link is generated as a “Secret Gist,” which will stay private as long as you keep it private. Always think twice before sharing the link, and before pushing your sessions to GitHub gist, ensure you use the Runme mask feature to keep your sensitive pieces secured.
+Runme will first prompt you to log into your GitHub account and grant write access to your Gist. After a successful login, a notification containing a link to the Runme Gist hosted on your GitHub will be displayed.
+
+The link is generated as a “Secret Gist,” which will stay private as long as you keep it private. Ensure you secure the link cautiously before pushing your sessions to GitHub Gist.
+Lastly, use the Runme mask feature to keep your sensitive pieces secured.
+
 
 ## **Visual Representation of Runme Gist**
 Here is a video that showcases the power of Runme Gist.
@@ -56,4 +63,9 @@ Here is a video that showcases the power of Runme Gist.
   <source src="/videos/Runme-gist.webm" type="video/webm" />
 </video>
 
-Congratulations, you have successfully learned how to use the Runme Gist feature. Note that it is possible to keep session output files offline and locally. You can read about that here. If you love this feature, kindly give Runme a star on GitHub.
+
+Congratulations! You have successfully learned how to use the Runme Gist feature.
+
+Note that session output files can be kept offline and locally.
+You can read about that [here](https://runme.dev/blog/runme-v3-pipeline-logs-and-artifacts). If you love this feature, kindly give [Runme a star](https://github.com/stateful/runme/stargazers) on GitHub.
+