http://svn.openfoundry.org/pugs/docs/Perl6/Spec/Documentation.pod
...is *way* out of date. It predates the meeting Ingy, Larry, Audrey,
and I had in Tokyo, in which most of the kinks were ironed out. I have
a new draft of S26 with the design team at the moment, and am close to
having a first cut
Perl6::Spec::Documentation is a draft spec for documentation formats for
use with Perl6.
My own reading of it is that POD still exists and is supported, while a
new wiki-like format "kwid" is added, and a framework for various
dialects is supported.
POD was successful for its simplicity. It was