Reviewing the use of admonitions
eric at christensenplace.us
Wed Jul 23 22:18:09 UTC 2008
-----BEGIN PGP SIGNED MESSAGE-----
I agree with the info and note being close. I do think that the caution
and warning could be defined differently. IF I were defining them I say
that CAUTION meant that you can do this but shouldn't unless you have
experience and WARNING means don't do this because you are getting ready
to fry your system. I wouldn't want to dilute the WARNING down as I
want users to really pay attention to what is being said there and not
just pass it by only to delete everything on their system inadvertently.
Just my 2 cents worth.
Paul W. Frields wrote:
| On Tue, 2008-07-22 at 12:07 +1000, David O'Brien wrote:
| I think the GNOME methodology makes the most sense. A tip offers
| helpful but possibly unsolicited advice. The info and note admonitions
| are far closer in meaning, and could easily be combined. Same goes for
| caution and warning; the warning is simply a caution on steroids, so to
| FWIW, I vote we go the GDP way.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org
-----END PGP SIGNATURE-----
More information about the docs