diff --git a/docs/basics.md b/docs/basics.md
index ef88402..6a718d1 100644
--- a/docs/basics.md
+++ b/docs/basics.md
@@ -14,7 +14,8 @@
 
 ## Set boot image
 
-> :warning: **Highly discourage**: only do this if sessions in the system has been deleted
+???+ warning "**Highly discourage**"
+      only do this if sessions in the system has been deleted
 
 ## Set boot configuration
 
diff --git a/docs/index.md b/docs/index.md
index b40bcf6..3157299 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -40,7 +40,8 @@ Manta aggregates information from multiple sources:
 
 ## Introduction
 
-> :warning: **WIP**: trying to fill the gap in cray and sat clis when managing clusters
+???+ warning "**WIP**"
+      trying to fill the gap in cray and sat clis when managing clusters
 
 Configuration inmutability: overwritting configurations used by clusters (nodes booting with an image linked to a configuration or runtime configuration) is a bad practice because the history of that configuration is lost. 
 
diff --git a/docs/sat.md b/docs/sat.md
index 569d7f2..847a3f1 100644
--- a/docs/sat.md
+++ b/docs/sat.md
@@ -60,7 +60,7 @@ session_templates:
 
 While sat bootprep templating seems very simple, manta uses a jinja2 template engine.
 
-???+ warning
+???+ warning "Using `-` in variable names is not recommended"
       A common mistake when dealing with jinja2 files is using `-` in variable names. This won't work since jinja will expand this as a math operator, to avoid this issue, try to use `_` instead.
       eg:
       When a jinja template engine sees this `{{ template-version }}` it will try to resolve template and version as 2 independent variables (variable `template` and variable `version`) and substrace them means. If those variables don't exists in the sessions var, then they will become `undefined` and the jinja template engine will try to substract the 2 undefined values `undefined - undefine`, then, the operation will fail. This however would work if the session vars contains: