diff --git a/main/_sources/roles/keycloak_realm.md.txt b/main/_sources/roles/keycloak_realm.md.txt
index 73d823f..d6ce30c 100644
--- a/main/_sources/roles/keycloak_realm.md.txt
+++ b/main/_sources/roles/keycloak_realm.md.txt
@@ -1,8 +1,9 @@
 keycloak_realm
 ==============
+<!--start description_realm -->
 
 Create realms and clients in [keycloak](https://keycloak.org/) or [Red Hat Single Sign-On](https://access.redhat.com/products/red-hat-single-sign-on) services.
-
+<!--end description_realm -->
 
 Role Defaults
 -------------
@@ -136,4 +137,4 @@ Author Information
 ------------------
 
 * [Guido Grazioli](https://github.com/guidograzioli)
-* [Romain Pelisse](https://github.com/rpelisse)
\ No newline at end of file
+* [Romain Pelisse](https://github.com/rpelisse)
diff --git a/main/roles/keycloak_realm.html b/main/roles/keycloak_realm.html
index b602a30..f2d37cc 100644
--- a/main/roles/keycloak_realm.html
+++ b/main/roles/keycloak_realm.html
@@ -115,7 +115,9 @@
              
   <section id="keycloak-realm">
 <h1>keycloak_realm<a class="headerlink" href="#keycloak-realm" title="Link to this heading"></a></h1>
+<!--start description_realm -->
 <p>Create realms and clients in <a class="reference external" href="https://keycloak.org/">keycloak</a> or <a class="reference external" href="https://access.redhat.com/products/red-hat-single-sign-on">Red Hat Single Sign-On</a> services.</p>
+<!--end description_realm -->
 <section id="role-defaults">
 <h2>Role Defaults<a class="headerlink" href="#role-defaults" title="Link to this heading"></a></h2>
 <table class="docutils align-default">