Mathesar work happens on GitHub. We create GitHub issues to track everything we’re working on for both design and code.
We track our tasks in the Mathesar GitHub project.
- The Active view lists everything that is currently in progress grouped by status.
- The Backlog view lists everything that is planned to be worked on by milestone.
- The Future view lists issues that we’ve created placeholders for to consider in the future. These issues are not actively planned to be worked on.
We do not pre-plan sprints. Team members are expected to pick up tasks as they have availability.
- Use the Backlog view to find tasks. Milestones are ordered and it’s expected that we complete a milestone before going on the next one.
- See Issue Assignment for the processs of picking up an issue.
- Design work is usually a milestone or two ahead of backend work, which is usually a milestone or two ahead of frontend work.
- All pull requests should follow the code review rules.
- All external contributors need to open an issue first before creating a pull request.
- Team members are allowed to create PRs for minor changes without a related issue.
This process is only valid until we have a first user. Then, it should be reviewed.
- Try to implement API changes in ways that do not cause breakage.
In case that’s unavoidable:
- Finish the changes to the API, and open a PR. This should be well documented, with a clear description of what the breaking changes are.
- Contact a front end dev directly, and ask them to look at the PR. At this point, they should just assess whether the needed front end changes are quick, easy, and feasible with a short turnaround time.
- Go through the normal review process for the back end code and API form to the point where all are happy with the API response format.
- If the front end devs are able to make appropriate front end changes easily and quickly, they should do so in the same PR.
- If not (i.e., if front end devs are busy, if it’s too complicated, or if the back end PR’s unmerged state starts to block too many things): merge the PR with a big warning (i.e., a comment @'ing multiple people).
- File an urgent bug describing the changes to the back end, and the needed changes to the front end.
For a list of public repos and other resources, see GitHub.
These resources are only available to the Mathesar core or community team at the moment.