[Doc-SIG] changing comment & directive syntax

David Goodger goodger at python.org
Mon May 31 13:30:15 EDT 2004

(was Re: ``invisible`` reST-directive)

Felix Wiemann wrote:
 > IMO it's much more intuitive than the '..' syntax for comments.
 > When the '.. invisible::' directive is available and when it is
 > being used, we can start phasing out the present comment syntax.

I'm still unconvinced that any change in the syntax is necessary.
I don't see enough benefit to justify the cost in broken documents.
This needs a lot of discussion before we make any changes at all.

Please read and consider all of the points in the entire "Reworking
Explicit Markup (Round 2)" section before forming an opinion:

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

More information about the Doc-SIG mailing list