Personally, I think that "warning" is stronger than "caution", and would
flip the signs that Paul proposed. To me, "caution" means that ignoring the
admonition could lead to unexpected results. "Warning" means that failure to
follow the admonition will not only lead to unexpected results, but that the
results could also be harmful.
The real world examples: "Caution, wet floor" is a common-place sign that is
commonly ignored, but still offers good advice. Warning labels on products
offer advice meant to spare life, limb, and health.
That's just a suggestion. I won't press the issue :). I'd rather have a set
of icons than a disagreement.
Peter- I really like the style of the second set of icons! Keep up the good
work.
Jake
On 7/18/07, Paul A Bristow <[EMAIL PROTECTED]> wrote:
>-----Original Message-----
>From: [EMAIL PROTECTED]
>[mailto:[EMAIL PROTECTED] On Behalf Of
>John Maddock
>Sent: 18 July 2007 09:53
>To: Boost documentation format, structure, and processing discussion
>Subject: Re: [Boost-docs] Seeking comments on some Custom SVG
AdmonitionIcons
I like custom icon 2 note (I in blue circle)
and custom icon 2 tip (Tango is also OK)
I like your SVG icons and agree the colours should be important yellow,
warning orange, caution red.
(Though of course a printed copy in black and white will mean these look
very similar/the same)
(What happens in pdfs?)
I think we need some definitions of what these mean to guide authors and
readers.
How about?
Note - generally useful information (an aside that doesn't fit in the flow
of the text). (blue i)
Tip - suggestion on how to do something (especially something that not be
obvious). (light bulb - lit!)
Important - (note) on something to take particular notice of. (yellow
triangle)
Warning - take special care with this - it may not be what you expect and
have bad results. (orange triangle)
Caution - 'skull and crossbones' - this is likely to cause serious trouble
if ignored. (red road sign triangle)
Paul
---
Paul A Bristow
Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB
+44 1539561830 & SMS, Mobile +44 7714 330204 & SMS
[EMAIL PROTECTED]
-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
