From 6fedc5252d21bc8d909b635baf7d73a44eb84364 Mon Sep 17 00:00:00 2001 From: Benjamin Peterson Date: Thu, 17 Sep 2009 03:27:33 +0000 Subject: rationalize a bit --- Doc/documenting/markup.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Doc/documenting/markup.rst b/Doc/documenting/markup.rst index 1d1023a..4c56cd2 100644 --- a/Doc/documenting/markup.rst +++ b/Doc/documenting/markup.rst @@ -597,8 +597,10 @@ units as well as normal text: An important bit of information about an API that a user should be aware of when using whatever bit of API the warning pertains to. The content of the directive should be written in complete sentences and include all appropriate - punctuation. This should only be chosen over ``note`` for information - regarding the possibility of crashes, data loss, or security implications. + punctuation. In the interest of not scaring users away from pages filled + with warnings, this directive should only be chosen over ``note`` for + information regarding the possibility of crashes, data loss, or security + implications. .. describe:: versionadded -- cgit v0.12