diff --git a/charts/xos-core.md b/charts/xos-core.md
index 54164c9..6f2bea2 100644
--- a/charts/xos-core.md
+++ b/charts/xos-core.md
@@ -7,16 +7,37 @@
 helm install -n xos-core xos-core
 ```
 
-We highly suggest you override the default values of `xosAdminUser`
-and `xosAdminPassword` with custom values. You can do it using a
-[`values.yaml`](https://docs.helm.sh/chart_template_guide/#values-files)
-file, or using this command:
+## Customizing sercurity information
+
+We strongly recommend you to override the default values of `xosAdminUser` and
+`xosAdminPassword` with custom values.
+
+You can do it using a [`values.yaml`](https://docs.helm.sh/chart_template_guide/#values-files)
+file like this one:
+
+```yaml
+# custom-security.yaml
+xosAdminUser: 'admin@onf.org'
+xosAdminPassword: 'foobar'
+```
+
+and add it to the install command:
+
+```shell
+helm install -n xos-core xos-core -f custom-security.yaml
+```
+
+or you can override the values from the CLI
 
 ```shell
 helm install -n xos-core xos-core --set xosAdminUser=MyUser --set xosAdminPassword=MySuperSecurePassword
 ```
+> **Important!**
+> If you override security values in the `xos-core` chart, you'll need to pass
+> these values, either via a file or cli arguments, to all the xos related charts
+> you will install, eg: `rcord-lite`, `base-openstack`, ...
 
-## Deploy Kafka
+## Deploy kafka
 
 Some flavors of XOS require kafka. To install it, please
 refer to the [kafka](kafka.md) instructions.
diff --git a/mdl_relaxed.rb b/mdl_relaxed.rb
index 92e3fe8..bebc671 100644
--- a/mdl_relaxed.rb
+++ b/mdl_relaxed.rb
@@ -48,3 +48,6 @@
 
 # Exclude rule: Emphasis used instead of a header
 exclude_rule 'MD036'
+
+# Gitbook won't care about multiple blank lines
+exclude_rule 'MD012'