From 22ad2d951a2e899f89fe5af4f8078f2de5b2e466 Mon Sep 17 00:00:00 2001
From: Daniel Burger <48986191+danielburger1337@users.noreply.github.com>
Date: Sat, 3 Feb 2024 14:26:00 +0100
Subject: [PATCH] Document `secrets:reveal` command

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

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 653bd92f611..089f7da2892 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -166,6 +166,22 @@ secrets' values by passing the ``--reveal`` option:
       DATABASE_PASSWORD   "my secret"
      ------------------- ------------ -------------
 
+Reveal Existing Secrets
+-----------------------
+
+If you have the **decryption key**, the ``secrets:reveal`` command allows
+you to reveal a single secrets value.
+
+.. code-block:: terminal
+
+    $ php bin/console secrets:reveal DATABASE_PASSWORD
+
+     my secret
+
+.. versionadded:: 7.1
+
+    The ``secrets:reveal`` command was introduced in Symfony 7.1.
+
 Remove Secrets
 --------------