.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" 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 >0, 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
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "CONTRIBUTING 3pm"
.TH CONTRIBUTING 3pm "2016-11-12" "perl v5.24.1" "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"
CONTRIBUTING
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
Information on contributing to SVN::Web
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
If you interested in contributing to SVN::Web there are several areas that
could definitely benefit from third party improvement.
.SS "Localising"
.IX Subsection "Localising"
All the English text in the templates \fBshould\fR be localised.  This makes
creating a new localisation as simple as adding the appropriate message
catalog file to \fIlib/SVN/Web/I18N/\fR.  If you have taken the time to
localise SVN::Web to your own language please send the message catalog to
the maintainers for inclusion in future releases.
.SS "Templates"
.IX Subsection "Templates"
It is very easy to change SVN::Web's look by creating a new set of templates
and adjusting the \f(CW\*(C`templatedir\*(C'\fR configuration directive.  If you've created
a new template set (perhaps to have SVN::Web's output mimic that of another
web based repository browser) then please contribute it back to the
maintainers for inclusion in future releases.
.SS "New actions"
.IX Subsection "New actions"
SVN::Web's design makes it simple to add new actions.  See SVN::Web::action
for details.
.PP
If you've created a new action then please contribute it back to the maintainers
for inclusion in future releases.
.PP
Some ideas for new actions include:
.IP "help" 4
.IX Item "help"
Would display help to the user.
.IP "atom" 4
.IX Item "atom"
Similar to the \f(CW\*(C`rss\*(C'\fR action, but generating \s-1ATOM\s0 format output instead.
.PP
Or look on \s-1CPAN\s0 for \s-1SVN\s0 related modules that could be usefully integrated.
Perhaps SVN::Log::Index or SVN::Churn could form the basis of useful
actions.
.SS "Bug reports and fixes"
.IX Subsection "Bug reports and fixes"
Of course, if you discover any bugs in SVN::Web please report them back to
the maintainers.  It's even more useful if you're able to include a test
case that reliably reproduces the bug.
.PP
Naturally, fixes for these bugs are even more useful.  Please see the
\&\*(L"\s-1BUGS\*(R"\s0 in SVN::Web section in SVN::Web for information about reporting
bugs.