Screenshots and uploading images

The following guidelines should be used for screenshots.

Usage
Screenshots are no substitute for text. Furthermore, they are harder to translate and not accessible. Do not use screenshots to list items in the interface: use a text list.

Use a screenshot only where it is needed to clarify something that would otherwise be confusing if it was only explained in the text.

Cropping:
Crop your screenshot to remove unnecessary detail. You can also use callouts and highlighting to draw attention to the relevant portion of the image.

Trim the browser from your screenshot: it takes up extra space on the page.
Crop surplus parts of the Drupal interface. For example, if you are showing the module admin page, you don't need to show more than a couple of module checkboxes for the reader to get the idea.

Windows XP:
Turn off ClearType font smoothing when taking screenshots under XP, if you can, please. Most people don't have this feature and it increases the file size somewhat.

Screenshot format

Screenshots on Drupal.org must follow these standards:

Format: PNG-8
PNG is preferred because of its lossless compression and small file size. JPEG is not suitable - it leaves artifacts and its 24-bit color depth is unnecessary when dealing with screenshots. GIF is not used because it is an outdated format.

Size:
700 x 700 pixels is the maximum preferred image size.

Uploading Screenshots

If you don't have edit rights:
Attach the image to an issue; that is, submit an issue (with Category "task") for the page you're updating and attach the image you wish to use. Then reference the URL in the page. At present, this appears to be the best method for regular handbook maintainers.

If you can edit the handbook page:

1. Attach the screen shot under file attachments
2. Change the input format from Filtered HTML to Documentation if it is not set to this already
3. Use the img tag in the body of the page to place the screen shot where you want it to go