From 608408431f9962d5b2b95ce47097d8379cf08d73 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 2 Jul 2024 13:18:13 +0200
Subject: [PATCH] Clarify not using the Config component for app configuration

---
 best_practices.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/best_practices.rst b/best_practices.rst
index 247d52fa15d..dafdfe8bc1c 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -109,6 +109,10 @@ Define these options as :ref:`parameters <configuration-parameters>` in the
 :ref:`environment <configuration-environments>` in the ``config/services_dev.yaml``
 and ``config/services_prod.yaml`` files.
 
+Unless the application configuration is reused multiple times and needs
+rigid validation, do *not* use the :doc:`Config component </components/config>`
+to define the options.
+
 Use Short and Prefixed Parameter Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~