while browsing the website in many different sections, I noticed some boxes that were shaded a light red or blue.
I was thinking that perhaps the red boxes could be consistantly used for all 'Caution' blurbs and the blue boxes for all 'Info' blurbs. I also came up with a color (hopefully the same tones) to be used for all the 'Warning' blurbs.
I have put together a little demo of what color boxes I'm
refering to: http://zirzow.dyndns.org/test.html
I'm not 100% sure how the documentation is involved with the actual web site (ie. css definitions). But it appears that this can easily be done with a little tweaking of the websites stylesheet and some changes to the defintions to the <caution> tags (not sure of the others tags) in the xml documentation.
IMO, i think this could make the documentation a little nicer using the colors instead of the table borders, and provide more emphasis on the warnings and cautions.
If people are + on this I'd like to help to make this change possible.
I very much like your idea, *BUT* we are (truly) slowly moving towards using livedocs for online documentation presentation. The goal is to use livedocs completely to generate the online manuals. Read more about it in the 2003 docmeeting findings (in CVS at phpdoc/RFC).
There is probably not much left in livedocs to extend to support those things we would need for online manual generation, but the development paused in recent months.
Wez had created a CVS module and a page for livedocs. You can see it here: http://thebrainroom.com/opensource/livedocs.php A sample output (of the somewhat older version of livedocs) can be seen here: http://www.php.net/~wez/fopen.html Note that livedocs can now display a full sidebar toc and other nice stuff since that output snapshot was generated. You can get the source from the above URL and play with it.
Goba
