[Catalyst-dev] RfC: Extending Catalyst POD

[hkclark at gmail.com]

Robert,

Looks like you have some excellent information in here.  Thank you for
writing it up... it should be a valuable update/addition to the docs!

Let me read through it and I'll get back to you... I saw a couple of minor
things on my first (quick) read through.

Thanks again,
Kennedy

On 3/9/07, Robert 'phaylon' Sedlacek <rs at 474.at> wrote:
>
> Good evening fellow codeslappers,
>
> since Catalyst::Manual::WritingPlugins is way (way!) outdated and even
> contains some bad practices (I wrote it at 5.33 time with very little
> actual Catalyst understanding) I wrote a successor named "Extending
> Catalyst." As you can surely guess, it would be great if -dev could
> review it before it goes public.
>
> You can find the whole beast at
>
>    <http://474.at/lab/ExtendingCatalyst.pod>
>
> And here, for convenience, the outline:
>
>    NAME
>    DESCRIPTION
>    BEST PRACTICES
>      Quick Checklist
>      Namespaces
>      Can it be a simple module?
>      Inheritance and overriding methods
>      Tests and documentation
>      The context object *
>    CONFIGURATION
>      Attributes
>      Creating custom accessors
>      Component configuration
>    IMPLEMENTATION **
>      Action classes
>      Component base classes
>      Controllers
>      Models and Views ***
>      Plugins *4
>      Factory components with COMPONENT() *5
>    SEE ALSO
>    AUTHOR
>    LICENSE AND COPYRIGHT
>
> Footnotes:
>   *   ACCEPT_CONTEXT stuff and model/app bondage warnings.
>   **  Sorted by 'smallest scope first.'
>   *** Details on what a View should do.
>   *4  Yes, it contains a metaphorical 'You don't want this.'
>   *5  mst: Please make sure I got this one right.
>
> I would very much appreciate any comments on this matter as a whole and
> the document specifically. I hope I got all the "its" vs. "it's" this
> time.
>
> Thanks again,
> phaylon
>
> --
> # Robert 'phaylon' Sedlacek
> # Perl 5/Catalyst Developer in Hamburg, Germany
> { EMail =3D> ' rs at 474.at ', Web =3D> ' http://474.at ' }
>
> _______________________________________________
> Catalyst-dev mailing list
> Catalyst-dev at lists.rawmode.org
> http://lists.rawmode.org/mailman/listinfo/catalyst-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.scsys.co.uk/pipermail/catalyst-dev/attachments/20070314/f=
8cffa8a/attachment.htm