diff --git a/backbone/README.md b/backbone/README.md
index 35f3252..5f640a3 100644
--- a/backbone/README.md
+++ b/backbone/README.md
@@ -3,8 +3,9 @@
Lightweight pattern to integrate reactive caching in all layers of a multiplatform application.
+
+
-
## The problem
diff --git a/cache-blocking/README.jvm.md b/cache-blocking/README.jvm.md
index 84aabf2..d61762d 100644
--- a/cache-blocking/README.jvm.md
+++ b/cache-blocking/README.jvm.md
@@ -3,8 +3,8 @@
Blocking wrappers for Pedestal Cache, for contexts in which coroutines are not available in.
-
-
+
+
# Package opensavvy.cache.blocking
diff --git a/cache/README.md b/cache/README.md
index 04a0ec5..d79109c 100644
--- a/cache/README.md
+++ b/cache/README.md
@@ -3,8 +3,8 @@
Pedestal Cache is a collection of in-process cache algorithms.
-
-
+
+
Caching is a powerful technique which allows to dramatically reduce I/O requests, making applications faster and more responsive.
For more information on our recommendations for cache-aware software architecture, see the Backbone module.
diff --git a/logger/README.md b/logger/README.md
index de5d6bf..97ac0be 100644
--- a/logger/README.md
+++ b/logger/README.md
@@ -3,8 +3,8 @@
Simple multiplatform [Logger][opensavvy.logger.Logger] interface that delegates to the logging facilities of the underlying platform.
-
-
+
+
Example usage:
diff --git a/progress-coroutines/README.md b/progress-coroutines/README.md
index 70448a0..b0bcf42 100644
--- a/progress-coroutines/README.md
+++ b/progress-coroutines/README.md
@@ -3,8 +3,8 @@
Compatibility layer for `progress` and KotlinX.coroutines.
-
-
+
+
Using the utility functions declared in this project, it is possible to report progress events from any coroutine
without changing its signature. Simply call the [report][opensavvy.progress.coroutines.report] function:
diff --git a/progress/README.md b/progress/README.md
index 88e22bb..d950df7 100644
--- a/progress/README.md
+++ b/progress/README.md
@@ -3,8 +3,8 @@
Lingua franca to represent the state of an unfinished task.
-
-
+
+
It is often recommended to communicate the progress of any task that doesn't finish instantly to the user.
However, this is often forgotten and implemented as a last-minute addition.
diff --git a/state-arrow/README.md b/state-arrow/README.md
index 20e540e..c9f7e49 100644
--- a/state-arrow/README.md
+++ b/state-arrow/README.md
@@ -3,7 +3,7 @@
Compatibility layer for `state` and [Arrow Core](https://arrow-kt.io/learn/typed-errors/working-with-typed-errors/).
-
-
+
+
All functionality from this module has been migrated into the `state` module. Please delete this module from your dependencies, it will be removed in Pedestal 3.0.
diff --git a/state-coroutines/README.md b/state-coroutines/README.md
index d134636..9a7b17e 100644
--- a/state-coroutines/README.md
+++ b/state-coroutines/README.md
@@ -3,5 +3,5 @@
Compatibility layer for `state` and KotlinX.Coroutines.
-
-
+
+
diff --git a/state/README.md b/state/README.md
index a7d63c6..97e695b 100644
--- a/state/README.md
+++ b/state/README.md
@@ -3,8 +3,8 @@
Small library for value-based outcome representation.
-
-
+
+
Using `state`, it is possible to model a successful operation, a failed operation, as well as the intermediate progress
states of an ongoing operation (using `progress`).
diff --git a/weak/README.md b/weak/README.md
index c15e1c5..a6dfe3a 100644
--- a/weak/README.md
+++ b/weak/README.md
@@ -3,8 +3,8 @@
Weak references and maps for Kotlin Multiplatform.
-
-
+
+
## Introduction