Re: Question about including screenshots into the documentation

On Fri, Sep 25, 2009 at 22:37, Ruslan Yakushev <ruslany@microsoft.com> wrote: > Hannes, > > What is the policy or a standard on including the UI screenshots into the PHP docs. For example > for Windows specific installation instructions it may be beneficial to show some UI screenshots to > help users to find the right settings (e.g. > http://learn.iis.net/page.aspx/246/using-fastcgi-to-host-php-applications-on-iis-70/) > > However, it looks like the usage of the screenshots in the PHP docs it not that common. So, > when writing IIS and Windows installation docs should I bother with screenshots or should I just > describe how to use command line for all the configuration steps? > The reason why we don't use images that much is, well, because there is nothing visual to show :) In the few cases there is something we do have some images, like http://no2.php.net/manual/en/function.imagecolorallocatealpha.php Rather then needing long barely readable paragraph to explain what to click or the location of things I think screenshots are very useful and it would be very appreciated if you would take the time to make them. Do note though: The _entire_ manual, including images, are licensed under CC-by. See http://www.php.net/manual/en/copyright.php for more info. -Hannes