Re: A comparison between P5 docs and p6 docs

2018-09-12 Thread Peter Scott
Ordinarily I would agree with you. But I know my own brain and how it works. I only learn by doing. Have tried to change that and can't. A good tutorial book *will* make you "do." The brian d foy book does exactly that with things to try, and questions to explore in your own code. It

Re: A comparison between P5 docs and p6 docs

2018-09-12 Thread Brad Gilbert
The signatures in the docs are often the exact same signatures as the code they are documenting. > Str.^lookup('contains').candidates.map: *.signature.say (Str:D: Cool:D $needle, *%_) (Str:D: Str:D $needle, *%_) (Str:D: Cool:D $needle, Cool:D $pos, *%_) (Str:D: Str:D $needle,

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread ToddAndMargo
On 09/11/2018 08:17 AM, Laurent Rosenfeld via perl6-users wrote: Hi Todd, I fully agree with Tom B.'s message that you should really set out to read a Perl 6 book. Many of the things you asked are covered in most of the available books. And the available books are easier than the official

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread ToddAndMargo
On 09/11/2018 08:52 AM, Tom Browder wrote: On Tue, Sep 11, 2018 at 10:39 AM Parrot Raiser <1parr...@gmail.com> wrote: One of the paradoxes of documentation, and the teaching of many abstract topics, is that those with the most in-depth knowledge of the ... I agree with you for the most part.

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread ToddAndMargo
On 09/11/2018 04:53 AM, Tom Browder wrote: Todd, some free advice: 1. DOCUMENTATION The docs are a volunteer effort. You can help by contributing changes and submitting issues. Hi Tom, I have started contributing to this effort as well. One of the big hurdles is that those maintaining the

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Tom Browder
On Tue, Sep 11, 2018 at 10:39 AM Parrot Raiser <1parr...@gmail.com> wrote: > > One of the paradoxes of documentation, and the teaching of many > abstract topics, is that those with the most in-depth knowledge of the ... I agree with you for the most part. But the docs DO have examples, and any

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Parrot Raiser
One of the paradoxes of documentation, and the teaching of many abstract topics, is that those with the most in-depth knowledge of the topic,are the least suitable to explain it, precisely because of that knowledge. They can't remember what it felt like not to know something, and they've usually

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Tom Browder
On Tue, Sep 11, 2018 at 10:31 AM Simon Proctor wrote: > > It's a very good read. :) Yes it is!

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Simon Proctor
It's a very good read. :) On Tue, 11 Sep 2018 at 16:19 Laurent Rosenfeld via perl6-users < perl6-us...@perl.org> wrote: > Hi Todd, > > I fully agree with Tom B.'s message that you should really set out to read > a Perl 6 book. Many of the things you asked are covered in most of the > available

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Laurent Rosenfeld via perl6-users
Hi Todd, I fully agree with Tom B.'s message that you should really set out to read a Perl 6 book. Many of the things you asked are covered in most of the available books. And the available books are easier than the official documentation for a beginner to start understand the basic underlying

Re: A comparison between P5 docs and p6 docs

2018-09-11 Thread Tom Browder
Todd, some free advice: 1. DOCUMENTATION The docs are a volunteer effort. You can help by contributing changes and submitting issues. Try to use the docs first instead of using an internet search. That will help you submit issues if you don't find what you are looking for. You really need to

A comparison between P5 docs and p6 docs

2018-09-11 Thread ToddAndMargo
Hi All, Not to beat a dead horse, but Perl 6's docs are miserably hard to understand. Here is a comparison of Perl 5's perldocs and Perl 6's docs: Perl 5: $ perldoc -f index index STR,SUBSTR,POSITION index STR,SUBSTR The index function searches for one string within another,