[Perl-org-patches] [PATCH] Add a Tutorials Page - Rework

[Shlomi Fish]

On Tuesday 13 Oct 2009 18:10:17 Chris Nehren wrote:
> Last night, I reworked Shlomi's tutorials page and cleaned up the
> language. While Shlomi's work served as a good starting point, I felt it
> could use a review by a native English speaker. I've made my diff
> against SVN HEAD as Shlomi did, rather than on top of Shlomi's patch.
> 

Hi, thanks for your effort. Here a few comments on the patch:

{{{{{{{{
+expects from reference material. Readers should supplement the material below
+with <a href="http://perldoc.perl.org/">perldoc</a>.
+</p>
}}}}}}}}

I would suggest explaining what "perldoc" is, as people who are new to perl 
may not be familiar with it. How about saying "the on-line Perl reference 
material that ships with perl (known as "perldoc").

{{{{{{{
+<h3><a href="http://perl-begin.org/tutorials/perl-for-newbies/">Perl for Perl 
+Newbies Series</a></h3>
+
+<p>
+Another tutorial, this one assumes no prior programming knowledge. It 
provides
+a basic but well-explained introduction.
+</p>
+
}}}}}}}

I should note that while I aimed to make P4N suitable for absolute beginners 
to programming, I'm not sure I successfully achieved this end. (I am the P4N 
originator). I also noticed that P4N also does not properly emphasises many 
fine points that newbies are likely to fall on.

One advantage it has over other tutorials is the fact that its text, code and 
sources are under the Public Domain (CC-Zero, etc.), and that it's probably 
mostly up-to-date and encourages good practices. But I think the paragraph 
there should be rephrased.

Hopefully, I'll get to it soon.

{{{{{{{{{
+These are collections of slides for talks members of the community have given
+at workshops and conferences.
+
}}}}}}}}}

maybe s/members/that members/? I found it hard to understand this sentence 
after reading it once.

Otherwise - looks good - thanks.

Regards,

	Shlomi Fish


-- 
-----------------------------------------------------------------
Shlomi Fish       http://www.shlomifish.org/
Freecell Solver - http://fc-solve.berlios.de/

Chuck Norris read the entire English Wikipedia in 24 hours. Twice.