[Doc-SIG] changing comment & directive syntax

[David Goodger]

(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:
http://docutils.sourceforge.net/spec/rst/alternatives.html

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