minor #17768 [Contributing] Mention php-symfony and php-standalone markup formats (alexandre-daubois)

javiereguiluz · javiereguiluz · commit 12741c8928bc · 2023-01-19T11:27:04.000+01:00
This PR was merged into the 5.4 branch. Discussion ---------- [Contributing] Mention `php-symfony` and `php-standalone` markup formats Commits ------- c396237 [Contributing] Mention `php-symfony` and `php-standalone` markup formats
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
@@ -90,11 +90,25 @@ The previous reStructuredText snippet renders as follow:
 
         // Configuration in PHP
 
+It may be relevant in some cases to write code examples when using the whole Symfony framework, but also
+when using components as standalone libraries without the whole framework installed. In this case, you
+may use special formats ``php-symfony`` and ``php-standalone``, which will be rendered like this:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        // PHP code using features provided by the Symfony framework
+
+    .. code-block:: php-standalone
+
+        // PHP code using standalone components
+
 The current list of supported formats are the following:
 
-===================  ======================================
+===================  ==========================================================================================
 Markup Format        Use It to Display
-===================  ======================================
+===================  ==========================================================================================
 ``html``             HTML
 ``xml``              XML
 ``php``              PHP
@@ -105,7 +119,9 @@ Markup Format        Use It to Display
 ``ini``              INI
 ``php-annotations``  PHP Annotations
 ``php-attributes``   PHP Attributes
-===================  ======================================
+``php-symfony``      PHP code example when using the Symfony framework
+``php-standalone``   PHP code to be used in a standalone context, for example when using standalone components
+===================  ==========================================================================================
 
 Adding Links
 ~~~~~~~~~~~~
