Re: Tech documentation (Re: Perl Apprenticeship Program)

2000-12-06 Thread David Grove
Kirrily Skud Robert [EMAIL PROTECTED] wrote: On Tue, Dec 05, 2000 at 11:28:31AM -0800, Nathan Wiger wrote: Anyways, that's just one suggestion. Do I have any idea where to find these mythical people? No, unfortunately. Perhaps some feelers on newsgroups might be a good place to

Re: Perl Apprenticeship Program

2000-12-06 Thread Dave Storrs
On Tue, 5 Dec 2000, Steve Fink wrote: David Grove wrote: Also, as far as documentation goes, I think it _should_ be written by apprentices, so that non-masters can understand it too. That's always been Except it's a particular duty that nobody really likes to perform. Which

Re: Perl Apprenticeship Program

2000-12-05 Thread Nathan Torkington
David Grove writes: 3. We seem to be creating a class system. Nate, this is one that I can see as a must-be, so I'm not going in _that_ direction. But let's still consider ourselves equal, regardless of rank, ok? Otherwise, perl 6 is a wash, because it's just as much about community as it is

Re: Perl Apprenticeship Program

2000-12-05 Thread David Grove
Don't miss the point. I'm not proposing to look for masters using brainbench, but for viable apprentices that way. Basic Perl skill seems a certian criterium for candidacy, as would basic c skill for some areas. I've also ranked master there, but only in Perl, not perlguts. I've proposed using

Re: Perl Apprenticeship Program

2000-12-05 Thread Casey R. Tweten
Today around 11:55am, David Grove hammered out this masterpiece: : Don't miss the point. I'm not proposing to look for masters using : brainbench, but for viable apprentices that way. Basic Perl skill seems a : certian criterium for candidacy, as would basic c skill for some areas. : I've also

Re: Perl Apprenticeship Program

2000-12-05 Thread Steve Fink
David Grove wrote: Also, as far as documentation goes, I think it _should_ be written by apprentices, so that non-masters can understand it too. That's always been a huge criticism of the perldocs. That's not grunt work. That's proper allocation of duties to the best suited personnel for the

Tech documentation (Re: Perl Apprenticeship Program)

2000-12-05 Thread Nathan Wiger
Steve Fink wrote: David Grove wrote: Also, as far as documentation goes, I think it _should_ be written by apprentices, so that non-masters can understand it too. Except it's a particular duty that nobody really likes to perform. One thing that might be really cool is if there was a

Re: Tech documentation (Re: Perl Apprenticeship Program)

2000-12-05 Thread Jonathan Scott Duff
On Tue, Dec 05, 2000 at 11:28:31AM -0800, Nathan Wiger wrote: One thing that might be really cool is if there was a way to get some tech documentation apprentices on-board just to specialize in perldocs. For example, people out of school interested in tech documentation but needing something

Re: Perl Apprenticeship Program

2000-12-05 Thread Kirrily Skud Robert
On Tue, Dec 05, 2000 at 11:05:43AM -0800, Steve Fink wrote: David Grove wrote: Also, as far as documentation goes, I think it _should_ be written by apprentices, so that non-masters can understand it too. That's always been a huge criticism of the perldocs. That's not grunt work. That's

Re: Tech documentation (Re: Perl Apprenticeship Program)

2000-12-05 Thread Mike Lacey
Documentation of Perl6 Internals, written by Apprentices and approved by their Mentors -- that would be *excellent* :-) - Original Message - From: "Nathan Wiger" [EMAIL PROTECTED] Subject: Tech documentation (Re: Perl Apprenticeship Program) . . other (good) stuff ommitted

Re: Tech documentation (Re: Perl Apprenticeship Program)

2000-12-05 Thread David Grove
Nathan Wiger [EMAIL PROTECTED] wrote: Steve Fink wrote: David Grove wrote: Anyways, that's just one suggestion. Do I have any idea where to find these mythical people? No, unfortunately. Perhaps some feelers on newsgroups might be a good place to start. Personal experience

Re: Perl Apprenticeship Program

2000-12-05 Thread David Grove
B. The "master" / "apprentice" relationship is just that - it depends how the people in question relate. As a potential "master" I am all too aware that I am not skilled in teaching - usually because I don't know what is obvious vs what is obscure - so anyone "taught" by me

Re: Perl Apprenticeship Program

2000-12-05 Thread David Grove
will have to do some proofreading (also tedious) no matter what. If the Bah. *I* like proofreading. Certainly for typos and English construction if I can forget everything other than the last 2 sentences I read. Masters have no reason to spellcheck. I mean they'll have to proofread for

Re: Tech documentation (Re: Perl Apprenticeship Program)

2000-12-05 Thread Kirrily Skud Robert
On Tue, Dec 05, 2000 at 11:28:31AM -0800, Nathan Wiger wrote: Anyways, that's just one suggestion. Do I have any idea where to find these mythical people? No, unfortunately. Perhaps some feelers on newsgroups might be a good place to start. Personal experience shows that this could be a

Re: Perl Apprenticeship Program

2000-12-05 Thread David Grove
Kirrily Skud Robert [EMAIL PROTECTED] wrote: On Tue, Dec 05, 2000 at 11:05:43AM -0800, Steve Fink wrote: David Grove wrote: Also, as far as documentation goes, I think it _should_ be written by apprentices, so that non-masters can understand it too. That's always been a