Reviewing the use of admonitions

Eric Christensen eric at christensenplace.us
Wed Jul 23 22:18:09 UTC 2008


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

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.

Eric



Paul W. Frields wrote:
| On Tue, 2008-07-22 at 12:07 +1000, David O'Brien wrote:
|> http://library.gnome.org/devel/gdp-style-guide/2.22/infodesign-18.html.en
|
| 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
| speak.
|
| 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

iEYEARECAAYFAkiHrh8ACgkQL5V8yddJCO1llQCeJOuiCdtsMVTqblUXn65pFT4y
2PUAnAxlLtFz6DOFGVZ51iknHRamTfbd
=fF3q
-----END PGP SIGNATURE-----




More information about the fedora-docs-list mailing list