<div dir="ltr">Some figure:: directives specify a scaling option (with :width:, :height:, or :scale:), some do not. There is a distinct difference between this: without a scaling option sphinx will generate a simple IMG directive, with scaling a CLASS directive is used with an HREF to the image.<div><br></div><div>Good examples of this are the first two large Example images in Compositing -> Node Types -> Converter Nodes -> Combine/Separate Nodes. The first has scale specified to 600px, the second no scale.</div><div><br></div><div>Normally, I would advocate the second un-scaled figure --- it fills the page width which makes it look nicer. The problem is that, even on a large workstation screen, I cannot read the textual detail of the nodes. Because the first image contains an HREF to the image, I can simply click on it to get the full image. I cannot do that on the second (non-scaled image) and must resort to browser zooming.</div><div><br></div><div>For usability we should do this one way or the other. The markup style guide gives good information regarding image creation but makes no recommendation on scaling.</div><div><br></div><div>-glen</div></div>