[issue14218] include rendered output in addition to markup

Éric Araujo report at bugs.python.org
Wed Mar 7 23:32:48 CET 2012


Éric Araujo <merwok at netwok.org> added the comment:

> For devguide/documenting, If you show me markup, also show me what output it gives me.
Would this really be useful?  If you’re looking at that page, you want to know what markup to use for what situation; why do you care about output?

> It's kinda tedious to keep building the markup just to verify how it's rendered.
I’m not sure I understand; if there were example output in the doc, you’d only have to build the devguide once to see how markup is rendered, wouldn’t you?

----------
nosy: +eric.araujo

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue14218>
_______________________________________


More information about the Python-bugs-list mailing list