From 00be928341f2768f4bba6ba7a7e2117202d5b578 Mon Sep 17 00:00:00 2001
From: emmanuelmaia <78927203+emmanuelmaia@users.noreply.github.com>
Date: Thu, 28 Aug 2025 15:02:52 -0300
Subject: [PATCH 1/2] Update README.md

Updated README.md with:
information on what is docusaurus
repository structure
steps on how to setup docusaurus for windows and other OS
mentioned the hot reload feature for development
added links to slack
---
 README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/README.md b/README.md
index 82cacc5..39636df 100644
--- a/README.md
+++ b/README.md
@@ -8,3 +8,62 @@ This document provides pointers for those looking to make documentation changes
 
 - [Documentation Overview](https://github.com/magma/magma/wiki/Contributing-Documentation) for general documentation information
 - `make help` for specific commands
+
+## What is Docusaurus?
+
+[Docusaurus](https://docusaurus.io/) is an open-source static site generator built by Meta and powered using React. It’s optimized for creating technical documentation websites for open-source projects, with support for document versioning, ready for translations, content search, and a hot reload feature.
+
+---
+
+## Repository Structure
+
+```text
+docusaurus/
+├── Dockerfile
+├── docker-compose.yml
+├── docs/
+├── docusaurus.config.js
+├── sidebars.js
+├── static/
+└── src/
+```
+
+---
+
+## How to Setup Docusaurus
+
+1. **Install Docker**  
+   Download and install [Docker Engine](https://docs.docker.com/engine/install/)
+   
+   For Windows, you must instead install [Docker Desktop](https://apps.microsoft.com/detail/XP8CBJ40XLBWKX?hl=pt-BR&gl=BR&ocid=pdpshare)
+
+3. **Clone the Repository**  
+   Open a terminal in any directory and run:  
+   ```bash
+   git clone https://github.com/magma/magma-documentation.git
+   ```
+
+4. **Start Docusaurus with Docker**  
+   You can now start Docker by opening it if you chose to install Docker Desktop or, for Docker Engine, with:
+   ```bash
+   sudo systemctl start docker
+   ```   
+   Navigate to the project folder:  
+   ```bash
+   cd magma-documentation/docusaurus
+   ```      
+   and set up Docusaurus by:  
+   ```bash
+   docker compose up dev
+   ```
+
+5. **Access the Documentation**  
+   Once running, open your browser and visit: [http://localhost:3000/](http://localhost:3000/)
+
+---
+
+## Contact
+
+For further assistance, join our [Slack channel](https://magmacore.slack.com/archives/C01PGTJECGJ)!
+
+

From eb17b98b5f74f553d56bcf89dc6a11be8485f939 Mon Sep 17 00:00:00 2001
From: emmanuelmaia <78927203+emmanuelmaia@users.noreply.github.com>
Date: Thu, 28 Aug 2025 23:40:21 -0300
Subject: [PATCH 2/2] Update README.md

---
 README.md | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 39636df..7f195e3 100644
--- a/README.md
+++ b/README.md
@@ -25,7 +25,8 @@ docusaurus/
 ├── docusaurus.config.js
 ├── sidebars.js
 ├── static/
-└── src/
+├── src/
+readmes/
 ```
 
 ---
@@ -43,11 +44,7 @@ docusaurus/
    git clone https://github.com/magma/magma-documentation.git
    ```
 
-4. **Start Docusaurus with Docker**  
-   You can now start Docker by opening it if you chose to install Docker Desktop or, for Docker Engine, with:
-   ```bash
-   sudo systemctl start docker
-   ```   
+4. **Start Docusaurus with Docker**     
    Navigate to the project folder:  
    ```bash
    cd magma-documentation/docusaurus
@@ -55,11 +52,20 @@ docusaurus/
    and set up Docusaurus by:  
    ```bash
    docker compose up dev
-   ```
+   ```   
 
 5. **Access the Documentation**  
    Once running, open your browser and visit: [http://localhost:3000/](http://localhost:3000/)
 
+6. **Proper Shutdown**  
+   You can stop this proccess without losing persistent data or associated configurations through:
+   ```bash
+   docker-compose stop
+   ```     
+   Or completely clean up your Docker environment with:  
+   ```bash
+   docker-compose down
+   ```
 ---
 
 ## Contact