Source

perl-begin / TODO.txt

Full commit
# Quicktask v1.2

CURRENT TASKS:
    - Add to the test parsing page the example of lib/regex-g-flag-example.pl .
      @ Added [Thu 2014-01-30]
    - Bad elems:
        - Use of the -w flag.
          @ Added [Sat 2014-05-10]
        - Use of superfluous .* in regexes.
          @ Added [Sat 2014-05-10]
    - Add a page about file/directory-handling :
        - Will share a lot of content with the Sys Admin page.
        - Refer to perldoc -f open and perldoc perlopentut.
        - Other CPAN modules.
            - File::Spec
            - File::Basename
            - File::Find
                - File::Find::Object
            - IO::All
            - File::Slurp
        - To add inotify/etc.
        - Add cookbook:
            - line count
                * DONE [Thu 2013-01-17]
            - reading files.
                @ DONE [Sun 2013-06-09]
            - appending selected portion from a file to another file.
            - prepending to files.
                @ DONE [Sun 2013-04-14]
            - overwriting lines in files.
            - writing to a file.
            - show all with IO::All and without it.
    - Link to:
        - http://blog.sei.cmu.edu/post.cfm/the-cert-perl-secure-coding-standard
        - https://www.securecoding.cert.org/confluence/display/perl/CERT+Perl+Secure+Coding+Standard

    - Add a page about training providers:
        - http://pti.co.il/ - Perl Training Israel.
        - http://perltraining.com.au/ - Perl Training Australia.
        - http://perltraining.org/

    - Perhaps a page about working with network protocols in general.

    - Add more information about:
        - URI parsing.
        - Filenames and paths parsing.

    - Books:
        - http://oreilly.com/catalog/0636920018476/ - Perl Pocket Reference.
            - All covering perl-5.14.x.
        - Peteris Krumins' Perl One-Liners Explained Book
            - TBD: which pages would be the best for it.


    - Fix the look of src/tutorials/hyperpolyglot/sheet1.html.wml
        - Add src/tutorials/hyperpolyglot/sheet2.html.wml

    - Fix the missing broken text in http://perl-begin.org/humour/#PHP.2C_Perl_and_the_meaning_of_.22my.22


LONG TERM:

    - Maybe a page on «What's next "after" perl?».

    - Pick up a better gvim colour scheme for the example code in the
    perl-for-newbies lecture.

    - Syntax-highlight the examples in the other code excerpts in the site
    (especially the src/tutorials/bad-elements/ ).

    - Add some screenshots to the /uses/games page.

    - XML Page:
        - mention XML::Twig, XML::Easy .

COMPLETED TASKS:
    - Bad elems: Parsing XML/HTML/JSON/CSV/etc. using regular expressions.
        @ DONE [Fri 2013-05-03]
    - Bad elems: Generally - don't use punctuation variables.
        @ DONE [Fri 2013-05-03]
    - Bad elems: Generating Invalid markup (HTML, etc.)
        @ DONE [Sat 2013-05-04]
    - Bad elems: Regex: capturing groups instead of clustering ones
        @ DONE [Tue 2013-05-21]
      * Captures are ( ... )
      * Clusters are (?: ... )
      @ Added [Mon 2013-05-06]
    - Bad elems: Regex: using $&, etc.
        @ DONE [Tue 2013-05-28]
      * Slows down the captures.
      * use English without -no_match vars.
      @ Added [Tue 2013-05-21]
    - Bad elems: Packaging as a CPAN distribution.
        @ DONE [Tue 2013-05-28]
    - Bad elems: unrelated packages (e.g: OtherModule) inside MyModule.
        - Preferably every package should be inside one module (except for
        private ones).
        @ DONE [Sun 2013-06-09]
    - Bad elems: non-explicit imports.
        - hard to track where identifiers come from.
        @ DONE [Sun 2013-06-09]
    - Bad elements: add a note about select(FILEHANDLE).
        @ DONE [Thu 2013-08-29]
      @ Added [Fri 2013-06-28]
    - Bad elems: add several synchronised arrays (e.g: my @names, my
        @ DONE [Sun 2013-10-27]
    - Bad elems: Excessive calls to subroutines in other packages (solution: OOP).
        @ DONE [Tue 2014-05-13]
        * e.g: MyModule::foo_bar(...) ; MyModule::other_stuff(...
        @ Added [Mon 2013-12-02]
    @addresses, my @ages, my @phone_numbers).
    - Tutorials:
        - http://qntm.org/files/perl/perl.html
            - “Learn Perl in about 2 hours 30 minutes”
                - Upsides:
                    - Short.
                    - To the point.
                    - Informative.
                - Downsides
                    - Does not mention/cover CPAN.
                    - Does not Moose/Mouse/Moo/etc..
    - Bad elems: http://perldoc.perl.org/perldata.html#Multi-dimensional-array-emulation
        @ DONE [Tue 2014-05-13]
      * $hash{$key1,$key2}
      @ Added [Thu 2014-03-27]

# vim:ft=quicktask:sw=4:ts=4:et