Pull Requests are welcome!
Here are a few useful information for contributing:
- If you are planning for a complex PR, we suggest that you check before hand whether your proposed changes are going to be accepted by posting your ideas in the Feature Requests discussion area
- For adding translations of locale dictionary files please follow the locales readme instructions here.
- Pagy repo setup
- Clone pagy:
git clone https://github.com/ddnexus/pagy && cd pagy
- Configure the git-hooks
- Clone pagy:
- Development
- Please create your own branch out of
master
and use it for you development and PR - Ensure you are basing your PR on the
master
branch and keep rebasing it onmaster
when it changes - Code
- You can have a decent development environment already setup by just using one of the apps in the Pagy Playground and/or with the Pagy::Console directly from the repo
- Docs
- The docs run on retype, and the repo is configured for its linux package. You may want to install the platform specific npm package in order to use it
cd
in the pagy root directory- Install bun
- Run
bun install
- Run
retype start
- Point your browser at
http://localhost:5000/pagy
for real-time feedback
- Please create your own branch out of
- Testing
- If your PR does not add any new feature (e.g. a fix), please, just ensure that the "All checks have passed" indicator gets green light on the PR page (if it's not enabled, a maintainer will enable it for you)
- If your PR adds new features, it needs Ruby testing and/or E2E testing or the coverage will fail. Ask for support if you need assistance.
Thank you!