diff --git a/peps/pep-0012.rst b/peps/pep-0012.rst index c269b60f2f1..377fc915db7 100644 --- a/peps/pep-0012.rst +++ b/peps/pep-0012.rst @@ -599,10 +599,10 @@ processed output using the ``image`` directive: .. image:: diagram.png -Any browser-friendly graphics format is possible; PNG should be +Any browser-friendly graphics format is possible; SVG or PNG are preferred for graphics, JPEG for photos and GIF for animations. -Currently, SVG must be avoided due to compatibility issues with the -PEP build system. +Images should be optimised to reduce their file size, and should +be legible in both light and dark mode in the browser. For accessibility and readers of the source text, you should include a description of the image and any key information contained within