X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FManual%2FDevelopmentProcess.pod;h=bee50d9163a2cc4c7c45613aab6aa3158e15e99a;hb=1eaebcbfb17e8cf9fd9c7d72ebcbbd726ebff5f3;hp=df23c76c0a713fabda638ca321e0c9a3038371f7;hpb=e91e320be26db95fc1bfdee31436cdbc09899cf7;p=catagits%2FCatalyst-Manual.git diff --git a/lib/Catalyst/Manual/DevelopmentProcess.pod b/lib/Catalyst/Manual/DevelopmentProcess.pod index df23c76..bee50d9 100644 --- a/lib/Catalyst/Manual/DevelopmentProcess.pod +++ b/lib/Catalyst/Manual/DevelopmentProcess.pod @@ -7,10 +7,10 @@ Catalyst::Manual::DevelopmentProcess - Administrative structure of the Catalyst =head2 Schedule There is no dated release cycle for Catalyst. New releases will be made -when sufficient small fixes have accumalated, or an important bugfix, or -significant feature addition is completed. +when sufficient small fixes have accumulated; or an important bugfix, or +significant feature addition, is completed. -=head2 Roadmanp for features +=head2 Roadmap for features The Catalyst Roadmap is kept at L @@ -28,24 +28,24 @@ for developing web-based MVC applications. This includes both technical decisions about the Catalyst core distribution, and public relations relating to the Catalyst framework as a whole. -The current goals of the Catalyst core development team are -be stability, performance, and a paced addition of features, with a -focus on extensibility. +The current goals of the Catalyst core development team are stability, +performance, and a properly paced addition of features, with a focus on +extensibility. -The core team are concerned with the 'core' Catalyst distributions +The core team is concerned with the 'core' Catalyst distributions (i.e. L, L and L), -and also tries to encourage best practices for extension authors and +and also tries to encourage best practices for extension authors, and cooperation and shared vision within the Catalyst community. =head2 Membership -The Catalyst Core Team consists of the developers that have full commit -privileges to the entire Catalyst source tree, who have made a significant +The Catalyst Core Team consists of the developers who have full commit +privileges to the entire Catalyst source tree, and who have made a significant contribution to the core Catalyst distributions, and various extensions and -pugins. +plugins. In addition, the core team includes members that have non-technical -roles such as marketing, legal, or economic responsibilities. +roles, such as marketing, legal, or economic responsibilities. Currently, the Core Team consists of the following people: @@ -87,12 +87,12 @@ concept for a feature to be committed to trunk. =head2 Organizational and Philosophical Decisions. -Any such decision should be decided by majority vote. Thus it should be -a goal of the organization that its membership number should at any time -be an odd number, to render it effective with regards to decision -making. The exceptions to this rule are changes to this charter and -additions to the membership of the Core Team, which require a 2/3 -majority. +Any organizational or philosophical decision should be decided by +majority vote. Thus it should be a goal of the organization that its +membership number should at any time be an odd number, to render it +effective with regards to decision making. The exceptions to this rule +are changes to this charter and additions to the membership of the Core +Team, which require a 2/3 majority. =head2 CPAN Releases @@ -105,30 +105,59 @@ correction, any member of the Core Team can perform a rescue release. The Core Team should strive to appear publicly as a group when answering questions or other correspondence. In cases where this is not possible, -the same order as for CPAN Releases applies. +the same order as for CPAN releases applies. =head1 Contributing to Catalyst -The main philosophy behind Catalyst development can be surimsed as: +The main philosophy behind Catalyst development can be summarized as: Patches welcome! Everyone is welcome (and will be encouraged) to contribute to Catalyst in whatever capacity they're able to. People in #catalyst-dev will be more than happy to talk newcomers through contributing their first patch, -or how best to go about their first CPAN extension module.. +or how best to go about their first CPAN extension module.... =head2 Repositories The Catalyst subversion repository can be found at: - http://dev.catalyst.perl.org/repos/Catalyst + svn: http://dev.catalyst.perl.org/repos/Catalyst + browser: http://dev.catalyst.perl.org/svnweb/Catalyst -and the git repository can be found at FIXME +and the git repository can be found at: -=head2 New Catalyst extensions + read: git://git.shadowcat.co.uk/catagits/PROJECTNAME + write: catagits@git.shadowcat.co.uk:PROJECTNAME + browser: https://git.shadowcat.co.uk/gitweb/gitweb.cgi + +=head2 New Catalyst Extensions As Catalyst is deliberately designed for extension, there is an ecosystem of -several hundred Catalyst extensions which can be found on CPAN. +several hundred Catalyst extensions that can be found on CPAN. + +See L for more information on how +to extend Catalyst in various ways and how to write CPANable components +for Catalyst which can be reused in many applications. + +It is recommended to post a request for comments to the Catalyst mailing +list, or ask around in the #catalyst IRC channel before starting to +implement something, as another member of the community is likely to +have example or prototype code that you can reuse, and members of the +community and core team are happy to advise on the best way to implement +a generic solution to a particular problem. + +This could save you duplicate work, and will help you produce a better +thought out and designed extension. + +=head1 AUTHORS + +Catalyst Contributors, see Catalyst.pm + +=head1 COPYRIGHT + +This library is free software. You can redistribute it and/or modify it under +the same terms as Perl itself. + +=cut -FIXME