diff --git a/README.md b/README.md
index c05eec0..2fd147e 100644
--- a/README.md
+++ b/README.md
@@ -1,25 +1,34 @@
-# Welcome to DevOpsCon CI/CD demo repo
+# 🌟 Welcome to DevOpsCon CI/CD demo repo
+
 ## This repository contains basic Maven project with Hello-World Java war for CI/CD workshop
-In order to make it work, please follow the instructions below: 
 
-> [!IMPORTANT] 
-> Make sure you have JAVA 21 (<b>JDK</b> and not <b>JRE standalone</b>) running on your laptop
+In order to make it work, please follow the instructions below:
+
+> [!IMPORTANT]  
+> Make sure you have JAVA 21 (**JDK** and not **JRE standalone**) running on your laptop  
+> ————————————————————————
+
+---
+
+### ⚙️ Setup Instructions
 
 <ul>
-  <li>Get Tomcat 9 (not version 10) - prefer the Core > Zip from <a href=https://tomcat.apache.org/download-90.cgi target=new>here</a></li>
-  <li>Configure under <TOMCAT DIR>/conf/tomcat-users.xml the code below</li>
-  <li>[LINUX / MAC] Please make sure you have running permissions on the /bin/ directory and run chmod +x *.sh</li>
-  <li>Restart tomcat [TOMCAT DIR]/bin/shutdown.sh & startup.sh (for non-Windows OS) or /bin/shutdown.bat & startup.bat</li>
-  <li>The Tomcat URL is <a href=http://localhost:8080/>http://localhost:8080/</a></li>  
-  <li>The application URL is <a href=http://localhost:8080/helloworld/>http://localhost:8080/helloworld/</a></li>  
+  <li>Get Tomcat 9 (not version 10) - prefer the Core > Zip from <a href="https://tomcat.apache.org/download-90.cgi" target="new">here</a></li>
+  <li>Configure under &lt;TOMCAT DIR&gt;/conf/tomcat-users.xml the code below</li>
+  <li>[LINUX / MAC] Please make sure you have running permissions on the /bin/ directory and run <code>chmod +x *.sh</code></li>
+  <li>Restart tomcat [TOMCAT DIR]/bin/shutdown.sh &amp; startup.sh (for non-Windows OS) or /bin/shutdown.bat &amp; startup.bat</li>
+  <li>The Tomcat URL is <a href="http://localhost:8080/">http://localhost:8080/</a></li>
+  <li>The application URL is <a href="http://localhost:8080/helloworld/">http://localhost:8080/helloworld/</a></li>
 </ul>
 
- > ```xml
- > <tomcat-users>
- >   <role rolename="manager-gui" />
- >   <role rolename="admin-gui" />
- >   <role rolename="manager-script" />
- >   <user username="admin" password="admin" roles="manager-gui,admin-gui,manager-script" />
- > </tomcat-users>
- > ```
- 
+---
+
+### 📝 XML Configuration
+
+```xml
+<tomcat-users>
+  <role rolename="manager-gui" />
+  <role rolename="admin-gui" />
+  <role rolename="manager-script" />
+  <user username="admin" password="admin" roles="manager-gui,admin-gui,manager-script" />
+</tomcat-users>
\ No newline at end of file