Developer's Guide

Rakudo is hosted at github at http://github.com/rakudo/rakudo/tree/master.

How to create a patch

Frew's Recommended Workflow

Bug tracking

The Perl Request Tracker (RT) system is used to track bugs and tasks for Perl 6 and Parrot. You will need a BitCard account to be able to modify tickets through the web interface. You can get a BitCard account if you don't have one already. You can just browse the bugs anonymously, however.

If you want to submit a bug, just send email to rakudobug@perl.org, which will open a ticket. There is no way to open a new ticket through the web interface. When reporting bugs, please try to include (the more of these, the better):

  • The revision or release of Rakudo that you were running when you encountered the bug (if you obtained Rakudo via git, you can get the revision number by running git rev-parse HEAD or by taking the first line from git log)
  • If you're running under a Parrot revision other than the one in build/PARROT_REVISION, the revision of Parrot (note - if you are running a different Parrot it's helpful if you can test if the bug occurs in the revision noted in build/PARROT_REVISION too)
  • What code you ran that caused the bug. The smaller the test case to reproduce the bug you can come up with, the better.
  • The output that was produced
  • The output that you expected (a reference to the Perl 6 specification is always nice to have)
  • A patch to fix it ;-)

Once you've got your bearings in RT, you may want to have a look at the RT command-line interface.