.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "Catalyst::Manual::DevelopmentProcess 3pm" .TH Catalyst::Manual::DevelopmentProcess 3pm "2014-04-05" "perl v5.18.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Catalyst::Manual::DevelopmentProcess \- Administrative structure of the Catalyst Development Process .SH "Contributing to Catalyst" .IX Header "Contributing to Catalyst" The main philosophy behind Catalyst development can be summarized as: .PP .Vb 1 \& Patches welcome! .Ve .PP 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 \s-1CPAN\s0 extension module.... .SH "Catalyst development" .IX Header "Catalyst development" .SS "Discussing proposed bugfixes or improvements" .IX Subsection "Discussing proposed bugfixes or improvements" has information about how to get in touch with the Catalyst \*(L"community\*(R". In particular, you would want to discuss a proposed change on the mailing list: .PP .Vb 1 \& http://lists.scsys.co.uk/cgi\-bin/mailman/listinfo/catalyst\-dev .Ve .PP or on \s-1IRC:\s0 .PP .Vb 2 \& irc://irc.perl.org/catalyst\-dev \& http://wiki.catalystframework.org/wiki/livegroups .Ve .PP Usually, the core team will be more than happy for you to contribute, and will talk you through how to submit a patch, or get a \*(L"commit bit\*(R". .SS "Repositories" .IX Subsection "Repositories" The Catalyst git repository can be found at: .PP .Vb 3 \& read: git://git.shadowcat.co.uk/catagits/PROJECTNAME \& write: catagits@git.shadowcat.co.uk:PROJECTNAME \& browser: https://git.shadowcat.co.uk/gitweb/gitweb.cgi .Ve .PP The Catalyst subversion repository can be found at: .PP .Vb 2 \& svn: http://dev.catalyst.perl.org/repos/Catalyst \& browser: http://dev.catalyst.perl.org/svnweb/Catalyst .Ve .SS "Schedule" .IX Subsection "Schedule" There is no dated release cycle for Catalyst. New releases will be made when sufficient small fixes have accumulated; or an important bugfix, or significant feature addition, is completed. .SS "Roadmap for features" .IX Subsection "Roadmap for features" The Catalyst Roadmap is kept at .SS "Bug list" .IX Subsection "Bug list" The \s-1TODO\s0 list with known bugs / deficiencies is kept at .SH "The Catalyst Core Team" .IX Header "The Catalyst Core Team" The intention of the Catalyst Core Team is to maintain and support the Catalyst framework, in order for it to be a viable and stable framework for developing web-based \s-1MVC\s0 applications. This includes both technical decisions about the Catalyst core distribution, and public relations relating to the Catalyst framework as a whole. .PP The current goals of the Catalyst core development team are stability, performance, and a properly paced addition of features, with a focus on extensibility. .PP The core team is concerned with the 'core' Catalyst distributions (i.e. Catalyst::Runtime, Catalyst::Devel and Catalyst::Manual), and also tries to encourage best practices for extension authors, and cooperation and shared vision within the Catalyst community. .SS "Membership" .IX Subsection "Membership" 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 plugins. .PP In addition, the core team includes members that have non-technical roles, such as marketing, legal, or economic responsibilities. .PP Currently, the Core Team consists of the following people: .IP "Brian Cassidy" 4 .IX Item "Brian Cassidy" .PD 0 .IP "Andy Grundman" 4 .IX Item "Andy Grundman" .IP "Christian Hansen" 4 .IX Item "Christian Hansen" .IP "Yuval Kogman" 4 .IX Item "Yuval Kogman" .IP "Marcus Ramberg" 4 .IX Item "Marcus Ramberg" .IP "Jonathan Rockway" 4 .IX Item "Jonathan Rockway" .IP "Jesse Sheidlower" 4 .IX Item "Jesse Sheidlower" .IP "Matt S. Trout" 4 .IX Item "Matt S. Trout" .IP "Florian Ragwitz" 4 .IX Item "Florian Ragwitz" .IP "Tomas Doran" 4 .IX Item "Tomas Doran" .PD .PP New members of the Core Team must be accepted by a 2/3 majority by the current members. .SS "Technical Decisions." .IX Subsection "Technical Decisions." Any change to the Catalyst core which can not be conceived as a correction of an error in the current feature set will need to be accepted by at least 3 members of the Core Team before it can be committed to master (which is the basis for \s-1CPAN\s0 releases). Anyone with access is at any time free to make a branch to develop a proof of concept for a feature to be committed to master. .SS "Organizational and Philosophical Decisions." .IX Subsection "Organizational and Philosophical Decisions." 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. .SS "\s-1CPAN\s0 Releases" .IX Subsection "CPAN Releases" Planned releases to \s-1CPAN\s0 should be performed by the release manager, at the time of writing Marcus Ramberg, or the deputy release manager, at the time of writing Florian Ragwitz. In the case of critical error correction, any member of the Core Team can perform a rescue release. .SS "Public statements from the Core Team" .IX Subsection "Public statements from the Core Team" 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 \s-1CPAN\s0 releases applies. .SS "New Catalyst Extensions" .IX Subsection "New Catalyst Extensions" As Catalyst is deliberately designed for extension, there is an ecosystem of several hundred Catalyst extensions that can be found on \s-1CPAN.\s0 .PP See Catalyst::Manual::ExtendingCatalyst 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. .PP It is recommended to post a request for comments to the Catalyst mailing list, or ask around in the #catalyst \s-1IRC\s0 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. .PP This could save you duplicate work, and will help you produce a better thought out and designed extension. .SH "AUTHORS" .IX Header "AUTHORS" Catalyst Contributors, see Catalyst.pm .SH "COPYRIGHT" .IX Header "COPYRIGHT" This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.