diff --git a/docs/qa.md b/docs/qa.md
index 2cc87cfe..4c8aa58e 100644
--- a/docs/qa.md
+++ b/docs/qa.md
@@ -3,7 +3,9 @@
 ??? info "**WIP**"
     This is work in progress
 
-List most common questions when using manta (don't put errors here)
+!!!+ hint "What should we put here?"
+    - List most common questions when using manta (eg: like a howto guide)
+    - Don't put errors here
 
 **Q: `manta get ...` only shows information for 1 cluster, I am missing other clusters data**
 
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index c84c6dac..a424e42e 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -3,7 +3,8 @@
 ??? info "**WIP**"
     This is work in progress
 
-List most common errors when using manta
+!!!+ hint "What should we put here?"
+    - List most common errors when using manta (eg: errors when config file does not have the right information)
 
 - Error with configuration file
 - Error with CSM CA root public certificate