Get Involved

Your help can make big difference

Getting involved with the Apache Royale Community is easy!

We are an open-source community governed by the Apache Software Foundation. Everything we do is out in the open with the entire community involved. All decisions are made on our mailing lists, and all source code is developed in GitHub.

Find out what is going on

If you are interested in what is going on with the project, subscribe to our mailing lists. Our dev@royale.apache.org mailing list is where additions and changes to the SDK are discussed. The list is open to everybody and everybody is encouraged to give their opinions on anything discussed on the list. This is a great place to introduce yourself and let us know how you can help.

If you are interested in helping end-users of the SDK, we also host the users@royale.apache.org mailing list. This list is designed for end-users to talk about how to use the SDK and how to build applications that utilize the SDK.

Contributing Documentation

If you are ready to help us document code, provide tips and tricks, or anything else that is not straight-up code, we have an Apache Royale Wiki in GitHub that allows for community contribution. Simply let us know on the dev@royale.apache.org mailing list that you wish to get write access to the Wiki.

You can contribute in this website with blog entries and articles. Share with us your Royale-related videos, screencasts, applications to showcase, and other materials that you have created. We would love to help publicize them!

Reporting Bugs

All bug reports that we receive are housed in the GitHub Issues system. To let us know about a bug, create an issue in GitHub. GitHub automatically emails the dev mailing list and hopefully somebody will take a look at it.

It is really important that you give us as much information on the bug as possible. Even better, if you have a way to reproduce the bug, submit a code sample that can help us reproduce it. Feel free to contribute to the comments as the bug gets worked on.

Squashing Bugs

Bugs happen, and you might know how to fix one! Because we don’t allow everybody write access to the official code repository (everybody has access to read, though!), there is an additional process that has to occur to submit a fix. To help us squash bugs, do the following :

  1. Find a bug you want to work on, or submit one into GitHub. Make a comment on the ticket that you plan on working on it so others don’t duplicate your work.
  2. Check out the source code from GIT. More information is available on the Source page.
  3. Set up your build environment. Check out the README included in the source code on how to do this. You will want to make sure that you can perform a compile before you go much further.
  4. Fix the bug. If you need help, ask the dev@royale.apache.org mailing list. I’m sure we have pointers to help you out.
  5. Create a pull request on GitHub.
  6. A committer will review the patch and make sure it dosen’t break anything else.
  7. Sit back and bask in the glory that you helped make Royale better!

Contributing Code

Due to legal reasons, only people who have been elected as committers have access to update or contribute code directly to the project. We at Apache take the legal status of code seriously, and nothing would be worse than somebody contributing code that they don’t own and a third party then having a legal claim to our framework.

That being said, you can submit code by providing pull request to the project in Github. To do this, create a new pull request.

If you submit a few patches that meet the Apache standards, you will probably be contacted by the PMC to provide you with direct access to the GIT and for you to be recognized for your work as a committer.

Join Apache Royale

Apache Royale needs your help. Want to be part of our community and contribute?

Join Us!

You can be part of Apache Royale and start using and contributing to this project. We need your skills to make this great technology reach the next step. You can start by joining us in our mailing list.