Using Screenshots

[Jordan Mantha]

On 7/29/07, Phil Bull <philbull at gmail.com> wrote:
> Hi guys,
>
> There have been a few questions about how best to use screenshots in the
> documentation recently. Do we have a definitive guide on using them?

I don't think we do, I think mostly because we haven't really
encouraged their use. Even though  "a picture is worth a thousand
words" sometimes it's more like "a picture is worth a thousand
headaches" :-)  The two big problems with screenshots are translation
and having to make sure that the UI has been frozen before the
screenshots are finalized. According to GutsyReleaseSchedule the
String Freeze is *before* the Final Artwork Deadline and Beta Release
so our screenshots could easily need to be redone after the String
Freeze.

To me the key is to be careful with screenshots. Balance the added
clarity to the documentation (which can be significant) with the
"cost" it's going to take to maintain the screenshot.

-Jordan

-- 
"That's all very well in practice, but will it ever work in theory?" -- G. Hill
"A tidy laboratory means a lazy chemist." -- Jöns Jacob Berzelius