Docs: Mark include_zones as internal consumed functionality

Asked during the Icinga Advanced training.

diff --git a/doc/17-language-reference.md b/doc/17-language-reference.md
index 9a606023822b1af53b067250893fbb5469f20cec..55c73ec58dcdc9aa893a44a397fb3fc18e79f238 100644 (file)
--- a/doc/17-language-reference.md
+++ b/doc/17-language-reference.md
@@ -756,6 +756,14 @@ When no pattern is specified the default pattern "*.conf" is used.
 
 ## Zone Includes <a id="zone-includes"></a>
 
+> **Note**
+>
+> This is an internal functionality consumed by Icinga itself.
+>
+> The preferred way for users managing configuration files in
+> zones is to use the [cluster config sync](06-distributed-monitoring.md#distributed-monitoring-top-down-config-sync)
+> or [REST API config packages](12-icinga2-api.md#icinga2-api-config-management).
+
 The `include_zones` recursively includes all subdirectories for the
 given path.