Skip to content

Latest commit

 

History

History
36 lines (32 loc) · 2.19 KB

CONTRIBUTING.md

File metadata and controls

36 lines (32 loc) · 2.19 KB
Raw

Pagy Contributions

Pull Requests are welcome!

Here are a few useful information for contributing:

  1. 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
  2. For adding translations of locale dictionary files please follow the locales readme instructions here.
  3. Pagy repo setup
  4. 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 on master 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
  5. 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!