diff --git a/docs/writing-helmfile.md b/docs/writing-helmfile.md
index e621d28a..7f7d5e36 100644
--- a/docs/writing-helmfile.md
+++ b/docs/writing-helmfile.md
@@ -127,6 +127,10 @@ Release Templating supports the following parts of release definition:
 
 See the [issue 428](https://github.com/roboll/helmfile/issues/428) for more context on how this is supposed to work.
 
+## Layering Release Values
+
+Please note, that it is not possible to layer `values` sections. If `values` is defined in the release and in the release template, only the `values` defined in the release will be considered. The same applies to `secrets` and `set`.
+
 ## Layering State Files
 
 > See **Layering State Template Files** if you're layering templates.