Skip to content

How To Contribute

Whether if you're technical or not, there are many ways to help improve the addon!

🐛 Bug Reports

If you experience any functionality that breaks or otherwise causes undesired effects, please make a Bug Report.

✨ Feature Requests

Not every possible feature has been planned nor considered, so if you feel there's something you would love to see please submit a Feature Proposal.

⌨️ Addon Contributions

If you're technically savy and would like to help making the addon better then code contributions are very welcome!

Large Changes

Examples

  • New features
  • Reworking how something works
  • Small changes that has system wide implications

Please do raise a Feature Proposal or Bug Report prior to committing to any work or submitting any PRs. This is just to be aligned on the goal and avoid anyone who wish to help spending time on things that might not get merged in the end.

If a bug report or feature proposal already exists and isn't in the current milestone, then please leave a comment on it and do have a go at it!

Minor Changes

Examples

  • Minor code changes that only affect specific area(s)
  • Bug fixes
  • Typos

Feel free to submit a PR with any minor changes without raising a ticket. Even small things helps a lot!

📃 Documentation Contributions

✍️ Text changes

If you spot a typo or other minor text issue, then please feel free to submit a PR with a correction!

For easy editing, each page has a link at the bottom that jumps to the corresponding GitHub editing page.

⌨️ Code changes

Excluding typos, to make changes that affects the site directly, such as the config files, Vue components or CSS, it's recommended to run the site locally using your preferred IDE.

The documentation site is using VitePress (Vue 3). It uses TypeScript, vanilla CSS and run using pnpm (as opposed to npm or yarn).

This site's GitHub repository can be found here.

Future Contribution Guide

There is plan to provide a codebase overview of the addon once it has reached a more mature stage, likely in version 1.0. The intent of it is to provide an easier onboarding flow to understand how all the scripts work and where to look to do specific things.