-

Author: javiereguiluz

contributing/documentation/format.rst

@@ -2,19 +2,17 @@ Documentation Format
 ====================
 
 The Symfony documentation uses `reStructuredText`_ as its markup language and
-`Sphinx`_ for generating the documentation in the formats read by the end users,
-such as HTML and PDF.
+a custom tool called `Docs Builder`_ for generating the documentation pages.
 
 reStructuredText
 ----------------
 
 reStructuredText is a plain text markup syntax similar to Markdown, but much
-stricter with its syntax. If you are new to reStructuredText, take some time to
-familiarize with this format by reading the existing `Symfony documentation`_
-source code.
+stricter with its syntax. If you are new to reStructuredText, check out the
+`reStructuredText Primer`_ tutorial and the `reStructuredText Reference`_.
 
-If you want to learn more about this format, check out the `reStructuredText Primer`_
-tutorial and the `reStructuredText Reference`_.
+You can also take some time to familiarize with this format by reading the
+existing `Symfony documentation`_ source.
 
 .. warning::
 
@@ -278,7 +276,8 @@ for Symfony versions that have a lower major version will be removed. For
 example, if Symfony 6.0 were released today, 5.0 to 5.4 ``versionadded`` and
 ``deprecated`` tags would be removed from the new ``6.0`` branch.
 
-.. _reStructuredText: https://docutils.sourceforge.io/rst.html
+.. _`reStructuredText`: https://docutils.sourceforge.io/rst.html
+.. _`Docs Builder`: https://github.com/symfony-tools/docs-builder
 .. _`Symfony documentation`: https://github.com/symfony/symfony-docs
 .. _`reStructuredText Primer`: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
 .. _`reStructuredText Reference`: https://docutils.sourceforge.io/docs/user/rst/quickref.html