Documenting Perl6

2007-07-02 Thread Mark Overmeer
=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

Re: Documenting Perl6

2007-07-02 Thread Jasmine Pues
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

Re: Documenting Perl6

2007-07-02 Thread Richard Hainsworth
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

Re: Documenting Perl6

2007-07-02 Thread Mark Overmeer
* 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