diff --git a/docs/user-guide/annotations.md b/docs/user-guide/annotations.md
index 5a267018f..4b9ed3db6 100644
--- a/docs/user-guide/annotations.md
+++ b/docs/user-guide/annotations.md
@@ -1,11 +1,11 @@
-**IMPORTANT:**
-
-The key and values in annotations can only be strings.
-This means that we want a value with boolean values we need to quote the values, like "true" or "false".
-Same for numbers, like "100".
-
 # Annotations
 
+!!! tip
+    Annotation keys and values can only be strings.
+    Other types, such as boolean or numeric values must be quoted,
+    i.e. `"true"`, `"false"`, `"100"`.
+
+
 The following annotations are supported:
 
 |Name                       | type |
@@ -71,8 +71,6 @@ The following annotations are supported:
 |[nginx.ingress.kubernetes.io/lua-resty-waf-ignore-rulesets](#lua-resty-waf)|string|
 |[nginx.ingress.kubernetes.io/lua-resty-waf-extra-rules](#lua-resty-waf)|string|
 
-**Note:** all the values must be a string. In case of booleans or number it must be quoted.
-
 ### Rewrite
 
 In some scenarios the exposed URL in the backend service differs from the specified path in the Ingress rule. Without a rewrite any request will return 404.
diff --git a/docs/user-guide/ingress-annotations.md b/docs/user-guide/ingress-annotations.md
deleted file mode 100644
index e69de29bb..000000000