2010/9/21 Nick Coghlan <ncogh...@gmail.com>: > On Tue, Sep 21, 2010 at 5:25 PM, Georg Brandl <g.bra...@gmx.net> wrote: >> I've been told that "Note that" should be removed altogether, as it's >> quite redundant :) > > I still find starting a paragraph with "Note that" to be useful as a > mild attention getter that isn't as shouty as an actual ReST note.
I think the preference should be to avoid phases like "Note that". For example the sentence in consideration could be phrased nicely as "See :ref:`custom-levels` for documentation on defining your levels." -- Regards, Benjamin _______________________________________________ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
