[Doc-SIG] Re: changing comment & directive syntax

[David Goodger]

Felix Wiemann wrote:
 > I think it's relatively easy to turn comments into directives in
 > existing documents.  A regexp should do for most cases.

It may be easy, but that doesn't mean it will be done, or should be
done.  Discussion is welcome, but please realize that it's an uphill
battle.

 > Anyway, after having the new invisible/comment directive for some
 > time, we can ask in Docutils-users if there are still many old-style
 > comments around.

We shall see.  But I'm currently strongly against "phasing out" the
present comment syntax.  If the explicit "comment" directive dominates
usage, then we'll reconsider.

ReStructuredText *is* markup.  User-friendly markup, but it's still
markup, and it requires some learning.

-- 
David Goodger <http://python.net/~goodger>