diff --git a/osgi/readme.md b/osgi/README.md
similarity index 94%
rename from osgi/readme.md
rename to osgi/README.md
index ee5d7d66c4..732f624302 100644
--- a/osgi/readme.md
+++ b/osgi/README.md
@@ -1,5 +1,9 @@
-OSGi
-====
+## OSGi
+
+This module contains articles about OSGi.
+
+### Relevant articles:
+ - [Introduction to OSGi](https://www.baeldung.com/osgi)
 
 Info
 ---
@@ -84,11 +88,7 @@ Oxygen.1 	Wed, 6 Sep 2017 -- 17:00 (-0400)
 
 org.eclipse.osgi_3.12.1.v20170821-1548.jar
 
- = = NOT GOOD = =
- 
- ## Relevant articles:
- - [Introduction to OSGi](https://www.baeldung.com/osgi)
- 
+ = = NOT GOOD = = 
 
 
 
diff --git a/patterns/README.md b/patterns/README.md
new file mode 100644
index 0000000000..bbc48e3f34
--- /dev/null
+++ b/patterns/README.md
@@ -0,0 +1,3 @@
+## Patterns
+
+This module contains articles about design patterns.
diff --git a/pdf/README.md b/pdf/README.md
index 8525dc4f69..8c7bd1fa26 100644
--- a/pdf/README.md
+++ b/pdf/README.md
@@ -1,3 +1,7 @@
+## PDF
+
+This module contains articles about PDF files.
+
 ### Relevant Articles:
 - [PDF Conversions in Java](https://www.baeldung.com/pdf-conversions-java)
 - [Creating PDF Files in Java](https://www.baeldung.com/java-pdf-creation)
diff --git a/performance-tests/README.md b/performance-tests/README.md
index 918c81bb69..09ed26ae19 100644
--- a/performance-tests/README.md
+++ b/performance-tests/README.md
@@ -1,3 +1,7 @@
+## Performance Tests
+
+This module contains articles about performance testing.
+
 ### Relevant Articles: 
 
 - [Performance of Java Mapping Frameworks](https://www.baeldung.com/java-performance-mapping-frameworks)
diff --git a/persistence-modules/README.md b/persistence-modules/README.md
new file mode 100644
index 0000000000..f6abc5782a
--- /dev/null
+++ b/persistence-modules/README.md
@@ -0,0 +1,3 @@
+## Persistence Modules
+
+This module contains articles about persistence. Actual articles go into its submodules. 
diff --git a/play-framework/README.md b/play-framework/README.md
index 2309b67422..a28c3f7ad7 100644
--- a/play-framework/README.md
+++ b/play-framework/README.md
@@ -1,4 +1,8 @@
-###Relevant Articles:
+## Play Framework
+
+This module contains articles about the Play Framework.
+
+### Relevant Articles:
 - [REST API with Play Framework in Java](https://www.baeldung.com/rest-api-with-play)
 - [Routing In Play Applications in Java](https://www.baeldung.com/routing-in-play)
 - [Introduction To Play In Java](https://www.baeldung.com/java-intro-to-the-play-framework)
diff --git a/protobuffer/README.md b/protobuffer/README.md
index 4302418a8b..329ad0e071 100644
--- a/protobuffer/README.md
+++ b/protobuffer/README.md
@@ -1,3 +1,7 @@
+## Google Protocol Buffer
+
+This module contains articles about Google Protocol Buffer.
+
 ### Relevant articles
 
 - [Introduction to Google Protocol Buffer](https://www.baeldung.com/google-protocol-buffer)
diff --git a/rabbitmq/README.md b/rabbitmq/README.md
index 01e51bd784..218b1a4b14 100644
--- a/rabbitmq/README.md
+++ b/rabbitmq/README.md
@@ -1,3 +1,7 @@
+## RabbitMQ
+
+This module contains articles about RabbitMQ.
+
 ### Relevant articles
 - [Introduction to RabbitMQ](https://www.baeldung.com/rabbitmq)
 
diff --git a/raml/README.MD b/raml/README.MD
index fcf0b41a18..2a3b9771be 100644
--- a/raml/README.MD
+++ b/raml/README.MD
@@ -1,2 +1,3 @@
-###The Course
-The "REST With Spring" Classes: https://bit.ly/restwithspring
+## RAML
+
+This module contains articles about the RESTful API Modeling Language (RAML).
diff --git a/ratpack/README.md b/ratpack/README.md
index 706fd0c8c3..9c24670709 100644
--- a/ratpack/README.md
+++ b/ratpack/README.md
@@ -1,3 +1,7 @@
+## Ratpack
+
+This module contains articles about Ratpack.
+
 ### Relevant articles
 
 - [Introduction to Ratpack](https://www.baeldung.com/ratpack)