diff --git a/README.md b/README.md
index e2df894..7a453cb 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,13 @@
-# The SLE BCI Distribution Image
+# openSUSE Tumbleweed OCI Container Registry (Distribution): Suitable for running a local OCI registry
 ![Redistributable](https://img.shields.io/badge/Redistributable-Yes-green)
 
-This container image allows to run a local OCI registry. Before you start the container,
+
+## Description
+This container image allows to run a local OCI registry.
+
+
+## Usage
+Before you start the container,
 you need to create a `config.yml` with the following content:
 
 ```yaml
diff --git a/distribution-image.changes b/distribution-image.changes
index df66322..23b443a 100644
--- a/distribution-image.changes
+++ b/distribution-image.changes
@@ -1,3 +1,8 @@
+-------------------------------------------------------------------
+Wed May  8 16:26:31 UTC 2024 - Dirk Mueller <dmueller@suse.com>
+
+- README fixes - better titles and follow recommended document structure
+
 -------------------------------------------------------------------
 Tue May  7 19:07:24 UTC 2024 - Dirk Mueller <dmueller@suse.com>