From 844f76dd1ae3a766f536d6a1b17b8aad606958ed Mon Sep 17 00:00:00 2001
From: Michael Friedrich <michael.friedrich@icinga.com>
Date: Tue, 4 Jun 2019 13:11:17 +0200
Subject: [PATCH] Docs: Mark include_zones as internal consumed functionality

Asked during the Icinga Advanced training.
---
 doc/17-language-reference.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/17-language-reference.md b/doc/17-language-reference.md
index 9a6060238..55c73ec58 100644
--- 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.