On 7/14/07, Mark Overmeer wrote:
[...] I sincerely hope that the summerizor is wrong:
. in the last week, the main people who are not happy with what I've
done have put out a document indicated what they'd like. I'm digesting
that and I'm going to try to explain how it can be made to fit
* Damian Conway ([EMAIL PROTECTED]) [070711 11:12]:
> Just a brief note to reassure Mark--and everyone else who's interested--
> that I'm not ignoring his post...I'm just fully occupied at the moment
> with other (paying) work. In the meantime I'm thinking very carefully
> about what Mark suggested
Just a brief note to reassure Mark--and everyone else who's interested--
that I'm not ignoring his post...I'm just fully occupied at the moment
with other (paying) work. In the meantime I'm thinking very carefully
about what Mark suggested. I'll reply properly as soon as I am able.
Damian
Hi Mongers,
Part one of this story, which I released last week on this list, was
really provoking people to rethink the way work work now (not!)
The challenge was made by Damian, to design a documentation system which
is easier to use: where code and doc work together, in stead of bei
* Richard Hainsworth ([EMAIL PROTECTED]) [070702 17:06]:
> Having read this posting, I find it VERY hard to understand exactly how
> Damian and Mark differ fundamentally. They both seem to be after the
> same thing in the end.
Damain defines a markup language, and says that "tools" (to be define
Having read this posting, I find it VERY hard to understand exactly how
Damian and Mark differ fundamentally. They both seem to be after the
same thing in the end.
A rhetorical question of my own and an answer.
Q) what is the real difference between comments and documentation?
- Syntactically
This may be unnecessary, but if anyone needs help with stylistic parts
of the documentation (I can cross-check for accuracy) for a target
audience (i.e., is it documentation for beginners, or those already
familiar with Perl5? Is it aimed toward other programmers who are
switching languages or usi
=begin INTRO
Mongers,
I must say, I am a bit disappointed that the discussions about the future
of documentation in Perl has died. Or was everyone fully occupied
by YAPC::NA? I spent last week with my family on a stormy island,
without sufficient internet access, so was unable to stirr things
