FAQ
Hi all,

The 2008 Catalyst advent calendar has started. In general this year
we will aim to have articles up by 12:00 UTC each day.

If you want to contribute an article, contact me (kd) on irc or via
email.

Kieren

Search Discussions

  • Kieren Diment at Dec 1, 2008 at 9:38 pm
    And of course I forgot the URL: http://www.catalystframework.org/calendar
    On 02/12/2008, at 8:01 AM, Kieren Diment wrote:

    Hi all,

    The 2008 Catalyst advent calendar has started. In general this year
    we will aim to have articles up by 12:00 UTC each day.

    If you want to contribute an article, contact me (kd) on irc or via
    email.

    Kieren

    _______________________________________________
    List: Catalyst@lists.scsys.co.uk
    Listinfo: http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/catalyst
    Searchable archive: http://www.mail-archive.com/catalyst@lists.scsys.co.uk/
    Dev site: http://dev.catalyst.perl.org/
  • Dan Dascalescu at Dec 2, 2008 at 1:22 am
    And of course I forgot the URL: http://www.catalystframework.org/calendar
    I'd like to suggest hosting the Advent Calendar articles on the Catalyst Wiki:
    http://dev.catalyst.perl.org/wiki/adventcalendararticles

    Here are some arguments:

    1. The presentation at http://www.catalystframework.org/calendar/2007
    does not list the article titles. It only lists the numbers from 1 to
    31 and finding an article later is a pain, as a blogger commented at
    http://www.simplicidade.org/notes/archives/2007/12/catalyst_advent.html
    Compare with the clear list at http://www.catalystframework.org/calendar/2007

    2. Some Advent entries become obsolete and are highly unlikely to be
    edited. For example, entry 14 of 2005 is severely obsoleted and an
    inspection of the SVN repo shows that the most recent revisions to the
    2005 and 2006 entries are 2 years old, and the 2007 entries are one
    year old.
    http://dev.catalystframework.org/svnweb/Catalyst/browse/trunk/examples/CatalystAdvent/root/2005/
    (for bonus points, try to figure out what "entry 14" is about... then
    hail SEO-friendly URLs)

    3. POD is not really conducive for the kinds of articles in the
    calendar. See the source of the Catalyst survey -
    http://dev.catalystframework.org/svnweb/Catalyst/checkout/trunk/examples/CatalystAdvent/root/2008/1.pod.
    Kd apparently had to resort to pasting HTML from a Word/OO document.
    The Catalyst wiki uses Multimarkdown, which makes table creation much
    easier and is generally less of a pain than POD.

    4. I proposed this on the channel and got the counter-arguments that
    SVN provides for peer review, and kd (manually) periodically makes the
    next entry availalbe. Well, MojoMojo provides for that too.
    Create/edit entries not to be released yet (e.g.
    http://dev.catalyst.perl.org/wiki/adventcalendararticles/2008/2008/03-sparklines_with_Chart_Clicker.edit),
    have the contributors edit, and link to them when they should be
    released.

    Finally, I found myself preferring the list of articles at
    http://dev.catalyst.perl.org/wiki/adventcalendararticles over the list
    of numbers at http://www.catalystframework.org/calendar/2007 every
    single time I tried to look for an article.

    HTH,
    Dan
  • Kieren Diment at Dec 2, 2008 at 1:46 am

    On 02/12/2008, at 12:22 PM, Dan Dascalescu wrote:

    And of course I forgot the URL: http://www.catalystframework.org/calendar
    I'd like to suggest hosting the Advent Calendar articles on the
    Catalyst Wiki:
    http://dev.catalyst.perl.org/wiki/adventcalendararticles

    Here are some arguments:
    Eventually everything gets linked to this page: http://dev.catalystframework.org/wiki/adventcalendararticles
    in the advent calendar template

    Other than that, patches welcome ;)
    1. The presentation at http://www.catalystframework.org/calendar/2007
    does not list the article titles. It only lists the numbers from 1 to
    31 and finding an article later is a pain, as a blogger commented at
    http://www.simplicidade.org/notes/archives/2007/12/
    catalyst_advent.html
    Compare with the clear list at http://www.catalystframework.org/calendar/2007

    2. Some Advent entries become obsolete and are highly unlikely to be
    edited. For example, entry 14 of 2005 is severely obsoleted and an
    inspection of the SVN repo shows that the most recent revisions to the
    2005 and 2006 entries are 2 years old, and the 2007 entries are one
    year old.
    http://dev.catalystframework.org/svnweb/Catalyst/browse/trunk/examples/CatalystAdvent/root/2005/
    (for bonus points, try to figure out what "entry 14" is about... then
    hail SEO-friendly URLs)

    3. POD is not really conducive for the kinds of articles in the
    calendar. See the source of the Catalyst survey -
    http://dev.catalystframework.org/svnweb/Catalyst/checkout/trunk/examples/CatalystAdvent/root/2008/1.pod
    .
    Kd apparently had to resort to pasting HTML from a Word/OO document.
    The Catalyst wiki uses Multimarkdown, which makes table creation much
    easier and is generally less of a pain than POD.

    4. I proposed this on the channel and got the counter-arguments that
    SVN provides for peer review, and kd (manually) periodically makes the
    next entry availalbe. Well, MojoMojo provides for that too.
    Create/edit entries not to be released yet (e.g.
    http://dev.catalyst.perl.org/wiki/adventcalendararticles/2008/2008/03-sparklines_with_Chart_Clicker.edit)
    ,
    have the contributors edit, and link to them when they should be
    released.

    Finally, I found myself preferring the list of articles at
    http://dev.catalyst.perl.org/wiki/adventcalendararticles over the list
    of numbers at http://www.catalystframework.org/calendar/2007 every
    single time I tried to look for an article.

    HTH,
    Dan

    _______________________________________________
    List: Catalyst@lists.scsys.co.uk
    Listinfo: http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/catalyst
    Searchable archive: http://www.mail-archive.com/catalyst@lists.scsys.co.uk/
    Dev site: http://dev.catalyst.perl.org/
  • Andrew Rodland at Dec 2, 2008 at 1:57 am

    On Monday 01 December 2008 07:22:48 pm Dan Dascalescu wrote:
    And of course I forgot the URL:
    http://www.catalystframework.org/calendar
    I'd like to suggest hosting the Advent Calendar articles on the Catalyst
    Wiki: http://dev.catalyst.perl.org/wiki/adventcalendararticles
    When you have a project with an internet presence, and you don't have time to
    do a proper job, you put up a wiki and hack it into doing what you want. When
    you have a bunch of web developers, and your project is web development, and
    you need something done that's really not wiki-ish at all, you _do it right_.
    If Advent sucks (yes, organization could be better, and markdown has its
    pros, as well as its cons that you seem to be ignoring), then help improve
    it. Schlepping it onto the wiki has its own set of problems, and isn't in
    itself a _solution_ to anything.

    Andrew
  • Dan Dascalescu at Mar 1, 2009 at 2:50 pm

    I'd like to suggest hosting the Advent Calendar articles on the Catalyst
    Wiki: http://dev.catalyst.perl.org/wiki/adventcalendararticles
    When you have a project with an internet presence, and you don't have time to
    do a proper job, you put up a wiki and hack it into doing what you want.
    You also put up a wiki when you want to have up-to-date information.

    Case in point:
    http://www.catalystframework.org/calendar/2006/6

    Imagine someone new to Catalyst who comes across that page. There's no
    notification whatsoever about the current state of BindLex.

    Another example: last night in #catalyst, a new user googled
    "deployment" and came across
    http://www.catalystframework.org/calendar/2005/17. There was no
    indication about modern deployment alternatives (listed at
    http://dev.catalyst.perl.org/wiki/deployment).
    When you have a bunch of web developers, and your project is web development,
    and you need something done that's really not wiki-ish at all, you _do it right_.
    How is documentation not wiki-ish at all?

    Time has proven that the CatalystAdvent application is just not
    conducive to host up-to-date documentation. Whoever wrote the articles
    just doesn't (have time to go back and) update them, and others don't
    contribute, for a variety of reasons.

    Here's the most frequent scenario of why someone checks the Advent
    entries: they are new to that particular area of Catalyst. If they
    stumble upon an obsolete article, or one with errors, will they go to
    the trouble of figuring out how to update the entry (that's not listed
    anywhere either, but, ironically, *is* listed on the wiki)? Will they
    get SVN permissions, check out, patch, then commit? Probably not. All
    these will be way over their PITA Threshold [1]. And those who do know
    how to update the entry, rarely revisit them, and are too caught up
    with larger projects to bother updating.

    [1] http://wiki.dandascalescu.com/essays/pita-threshold

    So yes, if we want to have a Catalyst history museum, CtalystAdvent rocks.
    If Advent sucks (yes, organization could be better, and markdown has its
    pros, as well as its cons that you seem to be ignoring),
    1. MojoMojo supports POD.
    2. We're talking about MultiMarkdown, which is what MojoMojo uses.
    What are MultiMarkDown's cons that POD doesn't have?
    Schlepping it onto the wiki has its own set of problems,
    Like? There's a lot of documentation on the wiki, and more gets added
    every week, as opposed to every December.
    and isn't in itself a _solution_ to anything.
    I honestly believe the wiki is a solution to each of the problems I
    mentioned in my first post:
    * obsoletion
    * presentation/accessibility
    * ease of collaboration
    * ease of editing (markup format) - random example: try to set the
    text of an external link in POD
    * plus, searchability. The Catalyst wiki has built-in search
    (incidentally not enabled ATM). CatalystAdvent has to be searched
    through an external search engine with the site: operator. Which
    brings us back to the second example above.

    Best regards,
    Dan
  • Chisel Wright at Dec 2, 2008 at 8:43 am

    On Tue, Dec 02, 2008 at 08:38:25AM +1100, Kieren Diment wrote:
    And of course I forgot the URL: http://www.catalystframework.org/calendar
    ... and because I'm a forgetful/lazy fecker, I've syndicated the feed in
    livejournal:

    http://syndicated.livejournal.com/catadvent08/

    Chisel
    --
    Chisel Wright
    e: chisel@herlpacker.co.uk
    w: http://www.herlpacker.co.uk/

    It's just a motivational meeting. I don't care if I miss it.
  • Jozef Kutej at Dec 6, 2008 at 8:25 pm
    Hi,

    the feed (http://www.catalystframework.org/calendar/feed/2008) in both
    Firefox and Liferea feed reader is showing also the tags for me. Like:

    Getting the word out with Catalyst::View::Email
    2008-12-06 17:00
    <div class="pod"> <h1 id="Getting_the_word_out_with_Catalyst_V">Getting
    the word out with Catalyst::View::Email</h1> <div
    id="Getting_the_word_out_with_Catalyst_V-2"> <p>I don' ...

    Strange...

    Jozef.

    Kieren Diment wrote:
    Hi all,

    The 2008 Catalyst advent calendar has started. In general this year we
    will aim to have articles up by 12:00 UTC each day.

    If you want to contribute an article, contact me (kd) on irc or via email.

    Kieren

    _______________________________________________
    List: Catalyst@lists.scsys.co.uk
    Listinfo: http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/catalyst
    Searchable archive: http://www.mail-archive.com/catalyst@lists.scsys.co.uk/
    Dev site: http://dev.catalyst.perl.org/

Related Discussions

Discussion Navigation
viewthread | post
Discussion Overview
groupcatalyst @
categoriescatalyst, perl
postedDec 1, '08 at 9:01p
activeMar 1, '09 at 2:50p
posts8
users5
websitecatalystframework.org
irc#catalyst

People

Translate

site design / logo © 2021 Grokbase