Skip to content

Latest commit

 

History

History
69 lines (42 loc) · 2.82 KB

CONTRIBUTING.md

File metadata and controls

69 lines (42 loc) · 2.82 KB
Raw

Contributing Guide

Help improve this project by:

Your contributions are appreciated and will be taken seriously.

How to Contribute

1. Create an issue

Report problems or suggest improvements by creating an issue.

2. Fork the project

Fork the repository to your GitHub account.

3. Make changes

Clone your fork locally and make the necessary changes:

git clone [email protected]:YOURNAMESPACE/postgresql_cluster.git

4. Test your changes (Optional)

4.1 Gitpod

Use Gitpod for a cloud-based development environment:

  1. Sign up for Gitpod: https://gitpod.io
  2. Fork the postgresql_cluster repository
  3. Open your fork in Gitpod: https://gitpod.io/#https://github.com/username/postgresql_cluster
  4. Create a new branch: git checkout -b my-feature-branch
  5. Make your changes and commit: git add . and git commit -m "Description of changes"
  6. Test with Molecule: make tests or make tests-fast
  7. Test with linters: make lint
  8. Push your changes: git push origin my-feature-branch
  9. Create a pull request on GitHub
  10. Wait for a review

Keep your Gitpod workspace synced with the main repository.

4.2 Desktop

Install make, Python3.10, venv, and docker.

Run make for Makefile help. Initialize virtualenv and install dependencies with make reinitialization-dev or make bootstrap-dev. Test your changes with make tests or make molecule-converge.

To test a specific distribution, set distro, tag, and namespace:

You can lint with make lint

IMAGE_NAMESPACE=geerlingguy IMAGE_DISTRO=debian10 make molecule-converge

5. Submit a pull request

Create a pull request and refer to the issue number using #123, where 123 is the issue number.

6. Wait

Your pull request will be reviewed, and you'll receive feedback. Thanks for contributing!

Consider sponsoring the maintainer via GitHub or Patreon.