docs: update readme (#147)

Signed-off-by: stefanicjuraj <[email protected]>

Author: stefanicjuraj

README.md

@@ -9,72 +9,93 @@
 
 <div align="center">
 
+[![Documentation](https://img.shields.io/github/v/release/daytonaio/docs?label=Docs&color=23cc71)](https://www.daytona.io/docs)
 [![License](https://img.shields.io/badge/License-Apache--2.0-blue)](#license)
 [![Issues - daytona](https://img.shields.io/github/issues/daytonaio/docs)](https://github.com/daytonaio/docs/issues)
 
 </div>
 
 <h1 align="center">Daytona Documentation</h1>
 <div align="center">
-Daytona's user and developer documentation.
+Daytona user and developer documentation.
 </div>
 </br>
 
 <p align="center">
-    <a href="https://github.com/daytonaio/docs/issues/new?assignees=&labels=bug">Report Bug</a>
+  <a href="https://github.com/daytonaio/docs/issues/new?assignees=&labels=bug">Report Bug</a>
     ·
   <a href="https://go.daytona.io/slack">Join Our Slack</a>
     ·
-    <a href="https://twitter.com/daytonaio">Twitter</a>
-  </p>
+  <a href="https://twitter.com/daytonaio">Twitter</a>
+</p>
 
-<hr/>
+The Daytona Documentation is developed with Astro and Starlight.
+Its core architecture leverages React, while documentation content is authored using Markdown (MDX).
 
-## Development
+## Getting Started
 
-The Daytona Documentation website is built using Astro and Stralight.
-The core of the website is built in React, with documentation and other content built in MDX.
+### Using Daytona (Recommended)
 
-### Setting up a Development Environment
-
-The easiest way to start working on the documentation is by using a DEM such as Daytona.
-You can create a Workspace with the dependencies and configuration needed to preview the docs locally by executing the following command:
+The most efficient way to begin working on the documentation is by utilizing a development environment manager (DEM) like Daytona. 
+To set up a Workspace with the necessary dependencies and configurations for local preview, run the following command:
 
 ```shell
 daytona create https://github.com/daytonaio/docs.git
 ```
 
-Alternatively, if your local machine has Node.js and Yarn set up, you can clone this repository and execute `yarn install` to install the required dependencies.
+### Manual
+
+Alternatively, if Node.js or Yarn are installed and set up on your local machine, you can clone this repository and install the required dependencies and configurations:
+
+```shell
+git clone https://github.com/daytonaio/docs.git
+```
+
+```shell
+yarn install
+```
 
 ### Useful Commands
 
-This repository uses Yarn to handle project management.
-For convenience, a number of scripts are defined in `package.json` that can be called using Yarn:
-
-| Command                         | Action                                                              |
-| :------------------------------ | :------------------------------------------------------------------ |
-| `yarn run dev`                  | Starts local dev server at `localhost:4321`                         |
-| `yarn run build`                | Builds your production site to `./dist/`                            |
-| `yarn run preview`              | Previews your build locally before deployment                       |
-| `yarn run astro ...`            | Runs CLI commands like `astro add`, `astro check`                   |
-| `yarn run astro -- --help`      | Provides help for using the Astro CLI                               |
-| `yarn run update-cli-reference` | Update the Daytona CLI reference docs using autogenerated CLI docs` |
-
-### Navigating the Docs
-
-On the filesystem, you'll find the content in `./src/content/docs` in the form of `.mdx` files.
-Daytona's documentation is organized into broad topics:
-
-- **Configuration**
-  Information around configuring the main components of Daytona.
-- **About**  
-   Background and conceptual information about Daytona and DEMs.
-- **Installation**  
-   Information around installing Daytona under different environments.
-- **Reference**  
-   Technical and architectural information about Daytona.
-- **Usage**  
-   Practical information on using Daytona.
+This repository utilizes `Yarn` to manage project dependencies and custom scripts. Below is a list of commonly used commands, defined in the `package.json`:
+
+| Command                    | Action                                                                       |
+| :------------------------- | :--------------------------------------------------------------------------- |
+| `yarn dev`                 | Starts the local development server at `localhost:4321`.                     |
+| `yarn build`               | Builds the production site to the `./dist/` directory.                       |
+| `yarn preview`             | Previews the production build locally before deployment.                     |
+| `yarn astro [command]`     | Runs Astro CLI commands.                                                     |
+| `yarn astro -- --help`     | Displays help information for the Astro CLI.                                 |
+| `yarn update-cli-reference`| Updates the Daytona CLI reference using autogenerated CLI documentation.     |
+
+### Documentation Structure
+
+The documentation is organized as `.mdx` files within the `/src/content/docs` directory.
+Daytona documentation is divided into the following key sections:
+
+- **`About`**  
+
+  Overview of Daytona's background and the concept of development environment manager (DEM).
+
+- **`Installation`**  
+
+  Instructions for installing Daytona across various environments.
+
+- **`Configuration`**
+
+  Guides to configuring Daytona's core components.
+
+- **`Usage`**
+
+  Practical instructions for using Daytona.
+
+- **`Reference`**
+
+  Detailed technical and architectural documentation for Daytona.
+
+- **`Miscellaneous`**
+
+  Additional information and resources related to Daytona.
 
 ## Contributing
 
@@ -101,5 +122,5 @@ This project has adapted the Code of Conduct from the [Contributor Covenant](htt
 
 ## Questions
 
-If you need guideance on contributing to Daytona, talk to us on
+If you need guidance on contributing to Daytona, talk to us on
 [Slack](https://go.daytona.io/slack).