diff --git a/docs/schema.md b/docs/schema.md
index 3d8632a..a046668 100644
--- a/docs/schema.md
+++ b/docs/schema.md
@@ -2,7 +2,12 @@
 
 ## Example
 
-An example of the schema can be found below and the description of the keys after the example.
+!!! note
+
+    An example of the schema can be found below and the description of the keys after the example.
+    For a full real-life example, you can refer to the `ias-o3a.json` file
+    in the [IAS O3a catalog release page](https://zenodo.org/records/14853304).
+
 
 ```json
 {
diff --git a/mkdocs.yml b/mkdocs.yml
index 989b1fb..e040b36 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -16,4 +16,6 @@ markdown_extensions:
       pygments_lang_class: true
   - pymdownx.inlinehilite
   - pymdownx.snippets
+  - admonition
+  - pymdownx.details
   - pymdownx.superfences