Re: [Python-markdown-discuss] Markdown package with debug statements

[Malthe B. <mb...@gm...>]

On 05/03/2008, Yuri Takhteyev <qar...@gm...> wrote:
>  Some debug messages are very specific to a particular bug.  Once the
>  bug is fixed, they can be removed.  Except that of course you are
>  never 100% sure that the change you made fully fixes the bug.  Sure it
>  passes specific tests, but someone will come up with another test that
>  will fail.  (Or you will come up with one in the shower the next
>  morning.)  So, if the bug fix is tentative, it makes sense to leave
>  the debug statements in, I think.  It does make sense to clean those
>  up eventually.  Additionally, some debug messages come in handy for
>  pretty much any debugging session.  In those cases it makes sense to
>  leave them around for longer.

I can see that there is no test suite included with the markdown
package; if believe that it would beneficial to move these debugging
statements out of the package and into a test suite (where you get to
explicitly define what you expect to see in those statements).

This way, you can let people know why you're interested in the output
and what you expect to see.

By the way: I'm only starting this thread because the markdown package
is great work and I'm a happy user :-)

\malthe