updated readme.md with setup "Working on the content" instructions for armbian 24.5.1

README.md

@@ -44,21 +44,45 @@ See the [document template](.github/DOCUMENT_TEMPLATE.md) before you writing any
 
 ## Working on the content
 
+### Prerequisites
+
+Ensure you have Python and the necessary development packages installed:
+
+```bash
+sudo apt-get update
+sudo apt-get install python3 python3-pip python3-venv python3.11-dev
+```
+### Cloning the Repository
+
+Next, clone the Armbian documentation repository:
+
 ```bash
 git clone https://github.com/armbian/documentation
+cd documentation
+```
+
+### Setting Up the Environment
+
+Set up a Python virtual environment to isolate the project dependencies:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
 pip install -r requirements.txt
-mkdocs build --clean && mkdocs serve
 ```
 
-You will be able to make edits to existing files and observe the results in real time.
+### Building and Serving the Documentation
 
-After changing text in an existing file, use this command to rebuild and view the documentation:
+To build and serve the documentation locally, allowing you to make edits and observe the results in real time, use:
 
-`mkdocs build --clean && mkdocs serve`
+```bash
+mkdocs build --clean && mkdocs serve
+```
 
-After adding a new file, either hand-edit `mkdocs.yml`, or re-run `tools/mkArmbianDocs.py` **unless making changes to the structure of the `docs/` folder**. (See below)
+You will be able to make edits to existing files and observe the results in real time.
 
 ## Generate tools
+After adding a new file, either hand-edit `mkdocs.yml`, or re-run `tools/mkArmbianDocs.py` **unless making changes to the structure of the `docs/` folder**. (See below)
 
 ### mkArmbianDocs.py
 Generate `mkdocs.yml` based on the contents of `docs/` folder