1Test2::Manual::ContribuUtsienrg(C3o)ntributed Perl DocumTeenstta2t:i:oMnanual::Contributing(3)
2
3
4
6 Test2::Manual::Contributing - How to contribute to the Test2 project.
7
9 This is a short manual page dedicated to helping people who wish to
10 contribute to the Test2 project.
11
13 REPORT BUGS
14 The easiest way to help is to report bugs when you find them. Bugs are
15 a fact of life when writing or using software. If you use Test2 long
16 enough you are likely to find a bug. When you find such a bug it would
17 help us out if you would submit a ticket.
18
19 BUG TRACKERS
20
21 Always try to find the preferred bug tracker for the module that has
22 the bug. Here are the big 3 for the main Test2 project:
23
24 Test2/Test-Builder/Test-More
25 <https://github.com/Test-More/test-more/issues>
26
27 Test2-Suite
28 <https://github.com/Test-More/Test2-Suite/issues>
29
30 Test2-Harness
31 <https://github.com/Test-More/Test2-Harness/issues>
32
33 SUBMIT PATCHES
34 You are welcome to fix bugs you find, or from the tracker. We also
35 often accept patches that add new features or update documentation. The
36 preferred method of submitting patches is a github pull request, that
37 said we also accept patches via email.
38
39 ADD/UPDATE DOCUMENTATION
40 Documentation can be flawed just like code can be. Documentation can
41 also become outdated. If you see some incorrect documentation, or
42 documentation that is missing, we would love to get a patch to fix it!
43
44 ANSWER QUESTIONS ON IRC/SLACK
45 We are always hanging out on <irc://irc.perl.org>, the #perl-qa and
46 #toolchain channels are a good place to find us.
47
48 There is also a Test2 slack channel: <https://perl-test2.slack.com>.
49
50 WRITE NEW TOOLS USING TEST2
51 Writing a new tool using Test2 is always a good way to contribute. When
52 you write a tool that you think is useful, it is nice to share it by
53 putting it on CPAN.
54
55 PORT OLD TOOLS TO TEST2
56 The "Test::*" namespace has been around for a long time, and has a LOT
57 of tools. The "Test2::Tools::*" namespace is fairly young, and has less
58 tools. Finding a useful old tool with no modern equivalent, and
59 writing a port is a very good use of your time.
60
62 Test2::Manual - Primary index of the manual.
63
65 The source code repository for Test2-Manual can be found at
66 https://github.com/Test-More/Test2-Suite/.
67
69 Chad Granum <exodist@cpan.org>
70
72 Chad Granum <exodist@cpan.org>
73
75 Copyright 2018 Chad Granum <exodist@cpan.org>.
76
77 This program is free software; you can redistribute it and/or modify it
78 under the same terms as Perl itself.
79
80 See http://dev.perl.org/licenses/
81
82
83
84perl v5.30.1 2020-01-31 Test2::Manual::Contributing(3)