From: Benjamin Peterson <benjamin@python.org>
Date: Thu, 17 Sep 2009 03:27:33 +0000 (+0000)
Subject: rationalize a bit
X-Git-Tag: v2.7a1~518
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6fedc5252d21bc8d909b635baf7d73a44eb84364;p=python

rationalize a bit
---

diff --git a/Doc/documenting/markup.rst b/Doc/documenting/markup.rst
index 1d1023a5d1..4c56cd2165 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