6489f49873
* Initial plan * Update documentation to use correct repository name PeakRDL-BusDecoder Co-authored-by: arnavsacheti <36746504+arnavsacheti@users.noreply.github.com> * Update CONTRIBUTING.md and GitHub templates with correct repository name Co-authored-by: arnavsacheti <36746504+arnavsacheti@users.noreply.github.com> * Update author to arnavsacheti and clarify bus decoder purpose in documentation Co-authored-by: arnavsacheti <36746504+arnavsacheti@users.noreply.github.com> * Update author to 'Arnav Sacheti' and revise UDP documentation to reflect no current UDP support Co-authored-by: arnavsacheti <36746504+arnavsacheti@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: arnavsacheti <36746504+arnavsacheti@users.noreply.github.com>
2.9 KiB
2.9 KiB
Contributing to the PeakRDL-BusDecoder code generator
We love your input! We want to make contributing to this project as easy and transparent as possible, whether it's:
- Reporting a bug
- Discussing the current state of the code
- Submitting a fix
- Proposing new features
- Becoming a maintainer
Open an issue using the Issue Tracker
Talking to us is the easiest way to contribute! Report a bug or feature request by opening a new issue.
Issue submission expectations:
- Please keep each issue submission limited to one topic. This helps us stay organized.
- Before opening an issue, check if one already exists for your topic. It may have already been discussed.
- If submitting a bug, provide enough details so we can reproduce it on our end. (version number, example SystemRDL, etc...)
- If submitting a feature request, please make sure ...
- ... it does not violate the semantics of the SystemRDL standard. Submissions that would change the interpretation of the SystemRDL language and are not faithful to the Accellera SystemRDL specification will be rejected. Additional notes on the spec's interpretation can be found in our unofficial errata page.
- Please be patient! This project is run by volunteers that are passionate about improving the state of register automation. Much of the work is done in their free time.
Contribute code using a pull request
Pull requests are the best way to propose changes to the codebase. We actively welcome your pull requests. To maximize the chance of your pull request getting accepted, please review the expectations below.
Pull request expectations:
- Before starting a pull request, please consider discussing the change with us first by opening an issue ticket. Unfortunately many of the PRs that get rejected are because they implement changes that do not align with the mission of this compiler project.
- PRs shall only contain only one feature/bug/concept change. Bulk PRs that change numerous unrelated things will be rejected.
- Your PR should provide proof that it works correctly and does not break the existing unit tests.
- Use meaningful commit messages, squash commits as appropriate.
How to submit a PR:
- Fork the repo and create your feature/bugfix branch from
main. - If you've added code that should be tested, add tests.
- Ensure the test suite passes.
- Submit the pull request!
Any contributions you make will be under the GNU LGPL-3.0 Software License
In short, when you submit code changes, your submissions are understood to be under the same LGPL-3.0 License that covers this project. Feel free to contact the maintainers if that's a concern.