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:

🧚 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 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