[Perl-org-patches] [PATCH] Add a Tutorials Page - Resend - Inline

[Matt S Trout]

On Wed, Sep 23, 2009 at 12:01:40PM +0300, Shlomi Fish wrote:
> Hi all!
> 
> What this untested patch does is add the http://perl-begin.org/tutorials/ page 
> from perl-begin.org to http://learn.perl.org/tutorials/ . There are more pages 
> on perl-begin in that section, and they were not added yet. We should also 
> consider putting some comprehensive free-as-in-speech tutorials on 
> learn.perl.org as is the case on http://perl-begin.org/ to preserve the look , 
> feel and common navigation and avoid some over-zealous firewalls.
> 
> Furthermore, I think we should have a side bar on the left or the right in 
> addition to, or instead of the top navigation bar, which can hold very few 
> links. See http://perl-begin.org/ for an example.
> 
> Included is the inline patch. I hope my mailer did not mangle it.
> 
> Regards,
> 
>         Shlomi Fish
> 
> 
> Index: learn/tpl/defaults
> ===================================================================
> --- learn/tpl/defaults	(revision 1470)
> +++ learn/tpl/defaults	(working copy)
> @@ -7,6 +7,7 @@
>  page.sidebar = BLOCK; -%]
>  <a href="/">Home</a> |
>  <a href="/faq/">FAQ</a> |
> +<a href="tutorials/">Tutorials</a> |

Shouldn't this be /tutorials/ for consistency?

>  <!-- <a href="/tips/">Tips</A> | -->
>  <a href="/library/">Online Library</A>
>  [%- END -%]
> Index: learn/tutorials/index.html
> ===================================================================
> --- learn/tutorials/index.html	(revision 0)
> +++ learn/tutorials/index.html	(revision 0)
> @@ -0,0 +1,150 @@
> +[%
> +page.title = "Perl Tutorials";
> +page.banner = "Perl Tutorials";
> +%]
> +
> +<h2 id="note">Note</h2>
> +
> +<p>
> +These online tutorials can provide an introduction to Perl so you can start
> +writing your own scripts. Nevertheless, they don't teach everything there is
> +to know about the language and one should still take care to learn all other
> +things on his own from other resources.
> +</p>
> +
> +<p>
> +If you prefer a tutorial in something else besides English, check the 
> +<a href="./localized/">foreign languages page</a>
> +</p>
> +
> +<h2 id="our_list">Our List of Tutorials</h2>

Why the id tags on EVERYTHING?

> +<h3 id="perl_for_newbies"><a href="perl-for-newbies/">Perl for Perl 
> +Newbies Series</a></h3>

Broken link. And assuming this one is yours perhaps it should be further down
the list on the perl.org form?

> +<h3 id="perl5_wiki"><a 
> href="http://www.perlfoundation.org/perl5/index.cgi?recommended_online_tutorials">A 
> +List of Recommended Online Tutorials</a></h3>
> +
> +<p>
> +An authoritative list of recommended tutorials.
> +</p>

It's on a wiki. How the fuck is it authoritative?

Also it's the shit ugly annoying TPF wiki most people try and avoid.

If that information isn't anywhere else a cleaned version of it should be
maintained in perl.org svn with a link back to the wiki page for freshness.

> +<h3 id="haifau_perl_course"><a 
> href="http://mila.cs.technion.ac.il/~yona/perl/">Haifa University Perl 
> Course</a></h3>
> +
> +<p>
> +A perl course with online slides.
> +</p>
> +
> +<h3 id="picking_up_perl"><a href="http://www.ebb.org/PickingUpPerl/">Picking 
> Up Perl</a></h3>
> +
> +<p>
> +A comprehensive tutorial by <a href="http://www.ebb.org/">Bradley M. Kuhn</a>
> +and others. Does not cover modules and objects, but should get you started
> +on simple scripts.
> +</p>

>From 2001 and incomplete.

Do we really need multiple ancient tutorials?

> +<h3 id="lpw-perl-beginners"><a 
> +href="http://www.slideshare.net/davorg/lpw-begin">LPW: Beginners Perl by Dave
> +Cross</a></h3>
> +
> +<p>
> +Presentation slides by Dave Cross.
> +</p>

What's the point of just slides when there are actual tuts too?

> +<h2 id="advanced">Tutorials for Advanced Users</h2>
> +
> +<p>
> +We don't know of any tutorials for advanced users in English, but
> +<a href="$(ROOT)/books/#with_prev_knowledge">there are some books just

This looks like a mistake?

> +for that</a>, some of which are freely available online.
> +</p>
> +
> +<h2 id="other_lists">Other Lists</h2>

Lists of lists?

Pick half a dozen good ones, put them here, link to the TPF wiki version
and the perlmonks one.

> +<h3 id="dmoz_category"><a 
> href="http://dmoz.org/Computers/Programming/Languages/Perl/FAQs,_Help,_and_Tutorials/">Dmoz 
> Category</a></h3>
> +
> +<p>
> +Links to many other online tutorials.
> +</p>

Most of which are crap. Why are we even linking to this?

> +<h3 id="perl_com"><a 
> href="http://www.perl.com/cs/user/query/q/6?id_topic=74">Perl.com's
> +List of Perl Tutorials</a></h3>

Why link to this -and- a specific perl.com article?

> +<h2 id="attribution">Attribution</h2>
> +
> +<p>
> +Based on <a href="http://perl-begin.org/tutorials/">Perl-Begin.org's
> +    tutorials page</a>.
> +</p>

No. We can discuss a contributors page or something later but there's no
justification for an "attribution" on a list of links like this.

-- 
        Matt S Trout         Catalyst and DBIx::Class consultancy with a clue
     Technical Director      and a commit bit: http://shadowcat.co.uk/catalyst/
 Shadowcat Systems Limited
  mst (@) shadowcat.co.uk        http://shadowcat.co.uk/blog/matt-s-trout/