TEST2::MANUAL::CONTRIBUTING(3pm)
π Test2::Manual::Contributing β bestie edition β¨
okay so you found the contributing page for Test2 (the man page header literally says Test2::...ributing(3pm) because man page headers are dramatic and love to truncate, and it lives in the Perl Programmers Reference Guide section, iykyk) π«Ά
β¨ NAME β¨
Test2::Manual::Contributing β like, literally: how to contribute to the Test2 project. that's it, that's the whole vibe π
πΈ DESCRIPTION πΈ
this is a short little manual page whose entire job is helping people who wanna contribute to the Test2 project. short king energy, but make it documentation π
π¦ WAYS TO HELP π¦
π REPORT BUGS π
the absolute easiest way to help? report bugs when you find them. bugs are just a fact of life when you're writing or using software β no cap, it happens to everyone. if you use Test2 long enough you're likely to find one. and when you do, it would genuinely help us out so much if you'd submit a ticket ποΈ
π₯ BUG TRACKERS π₯
always try to find the preferred bug tracker for the module that actually has the bug. here are the big 3 for the main Test2 project:
Test2/Test-Builder/Test-More/test-moreβ <https://github.com/Test-More/test-more/issues>Test2-Harnessβ <https://github.com/Test-More/Test2-Harness/issues>
π§ SUBMIT PATCHES π§
you are so welcome to fix bugs you find yourself, or grab one from the tracker. we also often accept patches that add new features or update documentation. the preferred method of submitting patches is a github pull request β but that said, we also accept patches via email π© (yes, email, she's still iconic)
π ADD/UPDATE DOCUMENTATION π
documentation can be flawed just like code can be, and it can also become outdated. if you see some incorrect documentation, or documentation that's missing, we would love to get a patch to fix it! docs glow-ups are valid contributions, periodt β¨
π¬ ANSWER QUESTIONS ON IRC/SLACK π¬
we are always hanging out on <irc://irc.perl.org> β the #perl-qa and #toolchain channels are a good place to find us π
there's also a Test2 slack channel: <https://perl-test2.slack.com>
π WRITE NEW TOOLS USING TEST2 π
writing a new tool using Test2 is always a good way to contribute. and when you write a tool you think is useful, it's nice to share it by putting it on CPAN π¦ β main character move fr fr
π PORT OLD TOOLS TO TEST2 π
the Test::* namespace has been around for a long time and has a LOT of tools. the Test2::Tools::* namespace is fairly young and has way fewer tools. so finding a useful old tool with no modern equivalent and writing a port? that's a very good use of your time. be the bridge, bestie π
β SEE ALSO β
Test2::Manualβ primary index of the manual. start here, it's giving table of contents energy ποΈ
π SOURCE π
the source code repository for Test2-Manual can be found at <https://github.com/Test-More/test-more/>.
π MAINTAINERS π
- Chad Granum
<exodist@cpan.org>
πΈ AUTHORS πΈ
- Chad Granum
<exodist@cpan.org>
π COPYRIGHT π
Copyright Chad Granum <exodist@cpan.org>.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See <http://dev.perl.org/licenses/>
π big legal energy up there but fr fr β free software, same terms as Perl itself, go read the license link, it's like two clicks, you got this π«Ά
and that's the whole page, bestie! sign-off time: this was perl v5.42.3, dated 2026-11-03, and the header/footer said Test2::...ributing(3pm) in the good old Perl Programmers Reference Guide. slay, go open a PR π
β¨
π¦ where this page comes from
- alpine 3.24: perl-doc 5.42.3-r0 Β· Artistic-1.0-Perl OR GPL-1.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms