Re: A grand idea on the documentation

2019-12-10 Thread ToddAndMargo via perl6-users
On 2019-12-10 07:31, Tom Browder wrote: On Mon, Dec 9, 2019 at 12:49 Peter Scott > wrote: ... Developers need reminders, in the most succinct form, to minimize time, of data that they should not need to memorize.  The documentation satisfies that need in the

Re: A grand idea on the documentation

2019-12-10 Thread Tom Browder
On Mon, Dec 9, 2019 at 12:49 Peter Scott wrote: ... Developers need reminders, in the most succinct form, to minimize time, > of data that they should not need to memorize. The documentation > satisfies that need in the same way that a phone book satisfies the need > to look up someone's

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 07:00, Elizabeth Mattijsen wrote: For some odd reason, some folks thought I was calling him an actual dog (canine). Would you have been similarly offended if I had called him a "gatekeeper"? If you call someone a dog I did not. It is a figure of speech. Please stop twisting

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 07:28, Curt Tilmes wrote: On Mon, Dec 9, 2019 at 10:08 AM Simon Proctor > wrote: I find both the implications of "guard dog" and "gatekeeper" unfair ways to talk about anyone on the community especially JJ. I understand that the intent

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 10:48, Peter Scott wrote: On 12/9/2019 6:06 AM, ToddAndMargo via perl6-users wrote: What school did you go to?  Students rate good and bad teachers, good and bad material ALL-THE-TIME. This is a function they are entitled to exercise because they are paying the teachers.  As

Re: A grand idea on the documentation

2019-12-09 Thread Peter Scott
On 12/9/2019 6:06 AM, ToddAndMargo via perl6-users wrote: What school did you go to?  Students rate good and bad teachers, good and bad material ALL-THE-TIME. This is a function they are entitled to exercise because they are paying the teachers.  As you yourself said: When I was in

Re: A grand idea on the documentation

2019-12-09 Thread Curt Tilmes
On Mon, Dec 9, 2019 at 10:08 AM Simon Proctor wrote: > I find both the implications of "guard dog" and "gatekeeper" unfair ways > to talk about anyone on the community especially JJ. > I understand that the intent was derogatory, but I would encourage JJ to take it as a compliment. He is a

Re: A grand idea on the documentation

2019-12-09 Thread Elizabeth Mattijsen
> On 9 Dec 2019, at 15:26, ToddAndMargo via perl6-users > wrote: > > On 2019-12-09 03:47, Elizabeth Mattijsen wrote: >>> On 9 Dec 2019, at 10:32, ToddAndMargo via perl6-users >>> wrote: >>> On 2019-12-09 00:33, JJ Merelo wrote: The Raku community has got a community documentation.

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 06:41, Simon Proctor wrote: I find both the implications of "guard dog" and "gatekeeper" unfair ways to talk about anyone on the community especially JJ. Hi Simon, JJ is indeed a great guy. That is not up for debate. He is just a little too protective when he is on duty.

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 06:23, Elizabeth Mattijsen wrote: On 9 Dec 2019, at 14:45, ToddAndMargo via perl6-users wrote: On 2019-12-09 01:39, Tom Blackwood wrote: It's rude on a public list to speak that. Did you seriously think I was calling him a real dog (canine)? So what did you intend to convey

Re: A grand idea on the documentation

2019-12-09 Thread Simon Proctor
I find both the implications of "guard dog" and "gatekeeper" unfair ways to talk about anyone on the community especially JJ. On Mon, 9 Dec 2019, 14:38 ToddAndMargo via perl6-users, < perl6-us...@perl.org> wrote: > On 2019-12-09 03:47, Elizabeth Mattijsen wrote: > >> On 9 Dec 2019, at 10:32,

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 03:47, Elizabeth Mattijsen wrote: On 9 Dec 2019, at 10:32, ToddAndMargo via perl6-users wrote: On 2019-12-09 00:33, JJ Merelo wrote: The Raku community has got a community documentation. It's called the official documentation, and it's done by the community. You want to write

Re: A grand idea on the documentation

2019-12-09 Thread Elizabeth Mattijsen
> On 9 Dec 2019, at 14:45, ToddAndMargo via perl6-users > wrote: > On 2019-12-09 01:39, Tom Blackwood wrote: >> It's rude on a public list to speak that. > Did you seriously think I was calling him a real dog (canine)? So what did you intend to convey with the use of the word "guard dog"? That

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 02:48, JJ Merelo wrote: No, it's not. I simply tried to direct you to raise an issue to where it would actually be heard by the people that maintain that. For you that don't know what JJ and I are talking about here, you can read it over at zef requires git

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 02:48, JJ Merelo wrote: And I'm not really going to answer to the rest. It's simply not true. You don't understand lots of things that are there, fair enough. You don't need to. I always tell my students: "keep trying, and ask around when you're lost". They never, however,

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 01:39, Tom Blackwood wrote: It's rude on a public list to speak that. Did you seriously think I was calling him a real dog (canine)? JJ! I do not think you are a canine. -T

Re: A grand idea on the documentation

2019-12-09 Thread Elizabeth Mattijsen
> On 9 Dec 2019, at 10:32, ToddAndMargo via perl6-users > wrote: > On 2019-12-09 00:33, JJ Merelo wrote: >> The Raku community has got a community documentation. It's called the >> official documentation, and it's done by the community. You want to write >> your own and help yourself and maybe

Re: A grand idea on the documentation

2019-12-09 Thread JJ Merelo
El lun., 9 dic. 2019 a las 11:26, ToddAndMargo via perl6-users (< perl6-us...@perl.org>) escribió: > On 2019-12-09 01:52, JJ Merelo wrote: > > > > > > El lun., 9 dic. 2019 a las 10:34, ToddAndMargo via perl6-users > > (mailto:perl6-us...@perl.org>>) escribió: > > > > On 2019-12-09 00:33, JJ

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 01:52, JJ Merelo wrote: El lun., 9 dic. 2019 a las 10:34, ToddAndMargo via perl6-users (mailto:perl6-us...@perl.org>>) escribió: On 2019-12-09 00:33, JJ Merelo wrote: > The Raku community has got a community documentation. It's called the > official

Re: A grand idea on the documentation

2019-12-09 Thread JJ Merelo
El lun., 9 dic. 2019 a las 10:34, ToddAndMargo via perl6-users (< perl6-us...@perl.org>) escribió: > On 2019-12-09 00:33, JJ Merelo wrote: > > The Raku community has got a community documentation. It's called the > > official documentation, and it's done by the community. You want to > > write

Re: A grand idea on the documentation

2019-12-09 Thread Tom Blackwood
On Mon, Dec 9, 2019 at 5:34 PM ToddAndMargo via perl6-users < perl6-us...@perl.org> wrote: > On 2019-12-09 00:33, JJ Merelo wrote: > > The Raku community has got a community documentation. It's called the > > official documentation, and it's done by the community. You want to > > write your own

Re: A grand idea on the documentation

2019-12-09 Thread ToddAndMargo via perl6-users
On 2019-12-09 00:33, JJ Merelo wrote: The Raku community has got a community documentation. It's called the official documentation, and it's done by the community. You want to write your own and help yourself and maybe others, there're lots lof places you can do that: dev.to ,

Re: A grand idea on the documentation

2019-12-09 Thread JJ Merelo
The Raku community has got a community documentation. It's called the official documentation, and it's done by the community. You want to write your own and help yourself and maybe others, there're lots lof places you can do that: dev.to, Medium, your own blog. Even the "official" Raku Advent

Re: A grand idea on the documentation

2019-12-08 Thread ToddAndMargo via perl6-users
On 2019-12-08 18:05, ToddAndMargo via perl6-users wrote: Hi All, I have a "grand idea" on how to fix up the documentation I would like to pitch to the community: > Lets create our own community documentation Wikipedia. I would like "Community Documentation" placed right next to

A grand idea on the documentation

2019-12-08 Thread ToddAndMargo via perl6-users
Hi All, I have a "grand idea" on how to fix up the documentation I would like to pitch to the community: Raku's documentation is pretty much unusable for newbies and regular users do to its culture: IEEE-eese like "method contains(Cool:D: |c)" and so on and so forth. Sometimes a usable example