* Damian Conway ([EMAIL PROTECTED]) [070621 08:07]:
> Mark Overmeer wrote:
> [...yet another honest and heartfelt plea for Pod 6 to be something
> entirely different from what it is currently designed to be.]
> The solution is simple, you know, Mark. Why not just write up your own
> alternate S26, redesigning Pod 6 the way you think it should work, and
> then publish your proposal for consideration here?
You may remember that I repeatedly asked @Larry not to forget the
documentation aspect in the redesign of Perl, in person during various
YAPCs and Workshops. Then, when you finally took the challenge, I have
send you a extensive email showing various alternative syntaxes for
condensed, integrated documentation strategies. (2 nov 2005)
Those design examples are far from a detailed design, because that
takes weeks, not hours. Besides, there are a few good alternatives
when the code/doc separation doctrine is left. For instance, Juerd's
"is documented" traits.
I have already proven that adding some simple logical markup to the POD(5)
syntax can simplify the documentation process enormously, with my OODoc
(::Parser::Markov). As I already reported in one of the initial messages
of this (long) thread, the tool saved me to type 700.000 characters of
(needed dupplicated) text for my MailBox suite alone. That was a simple
gain within the classical POD dogma; with real integration, we can
reduce our documentation efforts much further.
[Shall I give a lightning talk on OODoc in action, at upcoming YAPC::EU?]
> After all, Larry's track record is clear: he's never once allowed
> someone's reputation or status (even his own!) to deter him from
> replacing an existing design with someone else's superior one.
True. However, when the common @Larry believe is that POD6 should build
on POD(5) ideas of orthodox orthogonalism, then it is a waste of my
sparse time. I am not afraid to take such challange, opposit of that:
otherwise this discussion probably had died out days ago. But I do have
a number of large Perl(5) projects on my hands already.
--
MarkOv
------------------------------------------------------------------------
Mark Overmeer MSc MARKOV Solutions
[EMAIL PROTECTED] [EMAIL PROTECTED]
http://Mark.Overmeer.net http://solutions.overmeer.net
