diff --git a/README.md b/README.md
index 76ca40c..3b82a67 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,25 @@
-# solace-quarkus
-Solace extension for Quarkus
+# Quarkus Solace
+
+[![Version](https://img.shields.io/maven-central/v/io.quarkiverse.solace/quarkus-solace?logo=apache-maven&style=flat-square)](https://search.maven.org/artifact/io.quarkiverse.solace/quarkus-solace)
+
+## Welcome to Quarkiverse!
+
+Congratulations and thank you for creating a new Quarkus extension project in Quarkiverse!
+
+Feel free to replace this content with the proper description of your new project and necessary instructions how to use and contribute to it.
+
+You can find the basic info, Quarkiverse policies and conventions in [the Quarkiverse wiki](https://github.com/quarkiverse/quarkiverse/wiki).
+
+In case you are creating a Quarkus extension project for the first time, please follow [Building My First Extension](https://quarkus.io/guides/building-my-first-extension) guide.
+
+Other useful articles related to Quarkus extension development can be found under the [Writing Extensions](https://quarkus.io/guides/#writing-extensions) guide category on the [Quarkus.io](https://quarkus.io) website.
+
+Thanks again, good luck and have fun!
+
+## Documentation
+
+The documentation for this extension should be maintained as part of this repository and it is stored in the `docs/` directory.
+
+The layout should follow the [Antora's Standard File and Directory Set](https://docs.antora.org/antora/2.3/standard-directories/).
+
+Once the docs are ready to be published, please open a PR including this repository in the [Quarkiverse Docs Antora playbook](https://github.com/quarkiverse/quarkiverse-docs/blob/main/antora-playbook.yml#L7). See an example [here](https://github.com/quarkiverse/quarkiverse-docs/pull/1).