diff --git a/docs/user/examples/index.md b/docs/user/examples/index.md
index ceecbd189..8014a2cc4 100644
--- a/docs/user/examples/index.md
+++ b/docs/user/examples/index.md
@@ -2,7 +2,8 @@
 
 ## Code setup
 
-Pull all the code for all examples simply by executing the script below:
+Pull all the code for all examples simply by
+executing the script below:
 
 ```bash
 #!/bin/bash
@@ -13,6 +14,9 @@ mv workspace/DTaaS-examples-main workspace/examples
 rm workspace/main.zip
 ```
 
-The code for all examples is now setup in the workspace/examples folder and is ready for creation and execution. 
+The code for all examples is now
+setup in the workspace/examples folder
+and is ready for creation and execution.
 
-The examples are hosted in [DTaaS examples repository](https://github.com/INTO-CPS-Association/DTaaS-examples)
+The examples are hosted in
+[DTaaS examples repository](https://github.com/INTO-CPS-Association/DTaaS-examples)
diff --git a/docs/user/examples/mass-spring-damper/mass_spring_damper.md b/docs/user/examples/mass-spring-damper/README.md
similarity index 69%
rename from docs/user/examples/mass-spring-damper/mass_spring_damper.md
rename to docs/user/examples/mass-spring-damper/README.md
index 187f2addb..90218a4b7 100644
--- a/docs/user/examples/mass-spring-damper/mass_spring_damper.md
+++ b/docs/user/examples/mass-spring-damper/README.md
@@ -1,16 +1,25 @@
 # Mass Spring Damper
 
 ## Overview
-The mass spring damper study comprises two mass spring dampers and demonstrates how the sucessive substitution technique can be used to ensure that a co-simulation is stable. More information about successive substitution and other co-simulation stabilization techniques, please see [this paper](https://arxiv.org/pdf/1702.00686v1).
 
+The mass spring damper study comprises two mass spring dampers
+and demonstrates how the sucessive substitution technique can
+be used to ensure that a co-simulation is stable. More information
+about successive substitution and other co-simulation stabilization
+techniques, please see [this paper](https://arxiv.org/pdf/1702.00686v1).
 
-# Example Diagram
+## Example Diagram
 
 ![Mass Spring Damper System](mass-spring-damper_multibody_system.png)
 
-# Example Structure
+## Example Structure
 
-There are two simulators included in the study, each representing a mass spring damper system. The first simulator calculates the mass displacement and speed of $m_1$ for a given force $F_k$ acting on mass $m_1$. The second simulator calculates force $F_k$ given a displacement and speed of mass $m_1$. By coupling these simulators, the evolution of the position of the two masses is computed.
+There are two simulators included in the study, each representing a
+mass spring damper system. The first simulator calculates the mass
+displacement and speed of $m_1$ for a given force $F_k$ acting on mass $m_1$.
+The second simulator calculates force $F_k$ given a displacement and speed of
+mass $m_1$. By coupling these simulators, the evolution of the position of
+the two masses is computed.
 
 ![Mass Spring Damper Structure](mass_spring_structure.png)
 
@@ -42,7 +51,7 @@ cd workspace/examples/digital_twins/mass-spring-damper
 
 If required, change the permission of files you need to execute, for example:
 
-```
+```bash
 chmod +x lifecycle/create
 ```
 
@@ -50,13 +59,13 @@ Now, run the following scripts:
 
 ### Create
 
-```
+```bash
 lifecycle/create
 ```
 
 ### Execute
 
-```
+```bash
 lifecycle/execute
 ```
 
diff --git a/mkdocs.yml b/mkdocs.yml
index 62673bba0..ff38e9582 100755
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -41,7 +41,7 @@ nav:
           - Lifecycle: user/digital-twins/lifecycle.md
       - Examples:
           - Overview: user/examples/index.md
-          - Mass Spring Damper: user/examples/mass_spring_damper.md
+          - Mass Spring Damper: user/examples/mass-spring-damper/README.md
           - Codebase: https://github.com/INTO-CPS-Association/DTaaS-examples
   - FAQ: FAQ.md
   - Developer: