How to Contribute

Translating the app

We want people around the world to use the workers control app. To achieve this, it’s crucial to translate the app into as many languages as we can. We are happy to help you with the translation process.

Contributing code

We appreciate contributions to the code! Before you start contributing, you’ll need to set up your development environment. The setup process is detailed in our Getting Started guide.

You can propose changes by forking the repository and creating a pull request on GitHub. Before submitting changes, run ./run-checks to ensure your code meets our standards.

Working on Milestones

Milestones are our way of organizing larger work packages (>50h of work) that have been identified as important for the project. Unlike regular Issues or Pull Requests, milestones follow a formal approval process that includes an obligatory RFC (Request For Comments). This structured approach helps us plan better and ensures that all developers are aligned with the project’s direction.

Milestone Lifecycle

  1. RFC Candidate
    • An Issue on GitHub that has potential to become a Milestone

    • Marked with the “rfc candidate” label

    • Requires initial conceptual work and discussion

    • View current candidates

  2. RFC (Request For Comments)
    • A detailed proposal marked with the “RFC” label

    • Must include a motivation for the change and a detailed implementation proposal

    • Sent to the programmers mailing list for visibility

    • Requires approval in an app group meeting

    • View current RFCs

  3. Active Milestone
    • Published on GitHub after RFC approval

    • Ready for implementation

    • View all milestones

Feel free to contribute to any of these stages.