Skip to content

Commit eb86242

Browse files
committed
minor #17807 [Standards] Freeze contractions decision in documentation standards (alexandre-daubois)
This PR was merged into the 5.4 branch. Discussion ---------- [Standards] Freeze contractions decision in documentation standards As a decision has been made in #17765, I think this could be a good idea to freeze this in the documentation standards, in case someone is wondering again in the future. Commits ------- 1888db4 [Standards] Freeze contractions decision in documentation standards
2 parents e712cf9 + 1888db4 commit eb86242

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

contributing/documentation/standards.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,10 @@ In addition, documentation follows these rules:
190190
* simply
191191
* trivial
192192

193+
* Contractions are allowed to be used across the documentation. This means
194+
you're allowed to write ``you would`` as well as ``you'd``, ``it is`` as
195+
well as ``it's``, etc.
196+
193197
.. _`the Sphinx documentation`: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#literal-blocks
194198
.. _`Twig Coding Standards`: https://twig.symfony.com/doc/3.x/coding_standards.html
195199
.. _`reserved by the IANA`: https://tools.ietf.org/html/rfc2606#section-3

0 commit comments

Comments
 (0)