From 2e4647d18fd569fb1591cec1d51d780fb1b75c69 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Mon, 8 Nov 2021 19:25:22 +0100
Subject: [PATCH] [FrameworkBundle] Document secret rename logic

---
 configuration/secrets.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 79d0071fde3..c1a342e9b72 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -98,6 +98,10 @@ in ``config/secrets/prod``. You can also set the secret in a few other ways:
     # or let Symfony generate a random value for you
     $ php bin/console secrets:set REMEMBER_ME --random
 
+.. note::
+
+    If you need to rename a secret, you must create the new one and remove the old one.
+
 Referencing Secrets in Configuration Files
 ------------------------------------------