[Perl-org-patches] What's Going On?

[Leo Lapworth]

On 5 October 2010 10:45, Shlomi Fish <shlomif at iglu.org.il> wrote:

> On Tuesday 05 October 2010 08:15:04 Leo Lapworth wrote:
>  > Anyway - have a read of the README here:
> >
> > http://github.com/ranguard/learn-perl-org
> >
> > This is what I'd like to make the focus of learn.perl.org - there would
> be
> > other resources on the site as well, but I'd like to focus on this and
> then
> > build up around it.
>
> OK, I've read the README, and made a GitHub pull request for a typo.


Applied thanks, I also updated the README line breaks as you suggested.


> But I don't like this direction:


I'm sorry to hear that.


> http://learn.perl.org/ should primarily be a portal
> and beginners' first-stop for learning Perl, similar to what
> http://perl-begin.org/ is now.


Perl-begin.org is confusing to use - I'm sure there is some great content
there, and I'd like to see that packaged into work examples, with tests and
documentation and more.

The learn.perl.org site will have some content that relates to the basics,
but that sort of documentation should really be part of the perldoc project
(which I've been told is in need of rewriting / cleaning up for 'modern'
Perl practices -
http://www.modernperlbooks.com/mt/2010/09/a-perldoc-pruning.html - so maybe
that would be a good place to introduce some of the perl-begin content?). It
would be far better to improve this documentation and link to it, rather
than forking off somewhere else.

e.g.
http://perldoc.perl.org/perlintro.html vs
http://perl-begin.org/tutorials/perl-for-newbies/part1/ - if perl-begin copy
is better then that should be used for perlintro - if it's not then the
perlintro documentation should be used - there is no advantage to having
both. If it is more than a basic intro, the it should work in the context of
an example module, which can then also include tests and POD, getting a
newbie into the habit of seeing Perl in this 'standard' format.

I want to focus learn.perl.org on learning by example - rather the learning
by reading about semantics - that's what perldoc, computer degrees and the
learning perl books (I think there is discussion of this being updated) are
for.

I'm not saying there won't be any other content other than this core idea,
but I want to make sure that it is not a duplication of other
projects/sources which would be better to link to instead of trying to
replicate.


> You have all the material on
> http://perl-begin.org/ at your disposal and I will gladly help you with
> that.
>

Thanks - maybe you could start porting some of the content into the perldoc
project - and once I've got a bit further we can discuss what could be
packaged into CPAN modules and what should be on the site as content.

Cheers

Leo
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.scsys.co.uk/pipermail/perl-org-patches/attachments/201010=
05/5522e0bf/attachment.htm