diff --git a/doc/src/sgml/images/README b/doc/src/sgml/images/README index dd29486a09..81b426c066 100644 --- a/doc/src/sgml/images/README +++ b/doc/src/sgml/images/README @@ -59,3 +59,10 @@ Notes: - The width should be set to something. This ensures that the image is scaled to fit the page in PDF output. (Other widths than 100% might be appropriate.) + +- SVG images should be scalable as they will be rendered in a variety + of places (web, PDF, etc.) as well as in different viewports + (desktop, mobile, etc.). To help the images successfully scale, + please employe a "viewBox" attribute in the svg tag. For example, + to set an image to contain a default width and heigh of 400x300, + you would use viewBox="0.00 0.00 400.00 300.00"