Closes #363

Added descriptions to some sheets and updated to ensure markdown.

Author: caffeine-rohit

Development.md

@@ -1,46 +1,64 @@
-# DSOMM
+# DevSecOps Maturity Model (DSOMM)
+
+## Introduction
+
+The DevSecOps Maturity Model (DSOMM) is an open-source framework designed to help organizations evaluate and improve their **DevSecOps** practices.  
+It provides structured **security maturity levels**, recommendations, and automation insights to enable teams to build **secure, efficient, and scalable software**.
+
+This guide walks you through **setting up the project locally**, making contributions, and submitting a pull request.
+
+## **Project Setup**
+
+### Development Server :-
 
-## Development server
 The DSOMM is based [Angular](https://angular.dev/) and uses npm for package management.
+
 - If you have not yet installed npm or the Angular command line tools, install them now. First [NodeJS](https://nodejs.org/en/download) (which provides npm), then Angular:
-``` 
+
+```bash
 npm install -g @angular/cli
-``` 
-- Clone the DSOMM repo
 ```
+
+- Clone the DSOMM repo
+
+```bash
 git clone https://github.com/devsecopsmaturitymodel/DevSecOps-MaturityModel.git
 ```
+
 - Change directory to DSOMM
-```
+
+```bash
 cd DevSecOps-MaturityModel
 ```
+
 - Install Dependencies
-```
+
+```bash
 npm install
 ```
+
 - **NB!** The DSOMM activities are maintained separately. Download the `generated.yaml` and put it in the required folder
-```
+
+```bash
 curl https://raw.githubusercontent.com/devsecopsmaturitymodel/DevSecOps-MaturityModel-data/main/src/assets/YAML/generated/generated.yaml -o src/assets/YAML/generated/generated.yaml
 ```
 
 - Run `ng serve` for a dev server. Navigate to `http://localhost:4200/`. The application will automatically reload if you change any of the source files.
 
-
-## Code scaffolding
+### Code scaffolding :-
 
 Run `ng generate component component-name` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module`.
 
-## Build
+### Build :-
 
 Run `ng build` to build the project. The build artifacts will be stored in the `dist/` directory.
 
-## Running unit tests
+### Running unit tests :-
 
 Run `ng test` to execute the unit tests via [Karma](https://karma-runner.github.io).
 
-## Coding Style Conventions
+### Coding Style Conventions :-
 
-- We follow the coding style defined by [ESLint](https://eslint.org/). 
+- We follow the coding style defined by [ESLint](https://eslint.org/).
 - We also use [Prettier](https://prettier.io/docs/en/index.html) as our opinionated code formatter.
 - To validate the schemas of the DSOMM yaml files in the IDE, it is recommended to use the VS Code extension [redhat.vscode-yaml](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml). The schemas are stored in /src/assets/YAML/schemas
-

src/assets/YAML/generated/README.md

@@ -1 +1,26 @@
-In this folder, the generated.yaml will be placed
+# Generated YAML Files
+
+This folder contains the `generated.yaml` file, which is dynamically created during the build process.  
+It stores configuration settings and other automatically generated data used by the DevSecOps Maturity Model (DSOMM).  
+
+## **What is `generated.yaml`?**
+
+- It is a machine-generated file that is **not meant to be manually edited**.
+- It helps in **storing configuration settings**, which are loaded at runtime.
+- Used by the application to dynamically configure settings.
+
+## **How is it Generated?**
+
+The `generated.yaml` file is created as part of the DevSecOps Maturity Model’s **build process**. If you don’t see this file after setup, make sure to run:  
+
+```sh
+npm run build
+```
+
+or
+
+```sh
+yarn build
+```
+
+This will generate the required **YAML** file.