Fix: README.md and directory

The current proposal doesn't work with provided instructions.

Author: nradakovic

README.md

@@ -2,6 +2,7 @@
 
 This repository serves as a **template** for setting up **C++ and Rust projects** using **Bazel**.
 It provides a **standardized project structure**, ensuring best practices for:
+
 - **Build configuration** with Bazel.
 - **Testing** (unit and integration tests).
 - **Documentation** setup.
@@ -14,49 +15,71 @@ The template includes a **basic "Hello World" example** for both **C++ and Rust*
 
 ## 📂 Project Structure
 
-| File/Folder           | Description |
-|-----------------------|-------------|
-| `README.md`          | Short description & build instructions |
-| `src/`               | Source files for the module |
-| `tests/`             | Unit tests (UT) and integration tests (IT) |
-| `docs/`              | Documentation (Doxygen for C++ / mdBook for Rust) |
-| `.github/workflows/`  | CI/CD pipelines |
-| `.vscode/`           | Recommended VS Code settings |
-| `.bazelrc`, `MODULE.bazel`, `BUILD` | Bazel configuration & settings |
-| `LICENSE.md`         | Licensing information |
-| `CONTRIBUTION.md`    | Contribution guidelines |
+| File/Folder                         | Description                                       |
+| ----------------------------------- | ------------------------------------------------- |
+| `README.md`                         | Short description & build instructions            |
+| `examples/`                         | Examples how to invoke targets of the module      |
+| `src/`                              | Source files for the module                       |
+| `tests/`                            | Unit tests (UT) and integration tests (IT)        |
+| `docs/`                             | Documentation (Doxygen for C++ / mdBook for Rust) |
+| `.github/workflows/`                | CI/CD pipelines                                   |
+| `.vscode/`                          | Recommended VS Code settings                      |
+| `.bazelrc`, `MODULE.bazel`, `BUILD` | Bazel configuration & settings                    |
+| `LICENSE.md`                        | Licensing information                             |
+| `CONTRIBUTION.md`                   | Contribution guidelines                           |
 
 ---
 
 ## 🚀 Getting Started
 
 ### 1️⃣ Clone the Repository
+
 ```sh
 git clone https://github.com/eclipse-score/YOUR_PROJECT.git
 cd YOUR_PROJECT
 ```
 
-### 2️⃣ Build the Project
-#### C++
+### 2️⃣ Build the Examples of module
+
+> DISCLAMER: Depending what module implements, it's possible that different
+> configuration flags needs to be set on command line.
+
+To build all targets of the module the following command can be used:
+
 ```sh
-bazel build //...
+bazel build //src/...
 ```
-#### Rust
+
+This command will instruct Bazel to build all targets that are under Bazel
+package `src/`. The ideal solution is to provide single target that builds
+artifacts, for example:
+
 ```sh
-bazel build //rust/...
+bazel build //src/<module_name>:release_artifacts
 ```
 
+where `:release_artifacts` is filegroup target that collects all release
+artifacts of the module.
+
+> NOTE: This is just proposal, the final decision is on module maintainer how
+> the module code needs to be built.
+
 ### 3️⃣ Run the Example
+
 #### C++
+
 ```sh
 bazel run //src:main
 ```
+
 #### Rust
+
 ```sh
 bazel run //rust:main
 ```
 
 ### 4️⃣ Run Tests
+
 ```sh
 bazel test //tests/...
 ```