pgbackweb/CONTRIBUTING.md

PG Back Web - Contribution Guidelines

Thank you for your interest in contributing to the PG Back Web project! Please follow these guidelines to ensure smooth collaboration and consistent code quality.

Open Source

This project is completely open source, so before making a contribution make sure you agree with the license in the LICENSE file and that all your contributions are under the same license.

This means that any contribution made to this project will be assumed to be made under the same license.

Main Branch Policy

• The main branch reflects the latest stable release of the project.
• No direct commits should ever be made to the main branch.
• All development work should happen in feature branches and merged via Pull Requests (PRs) into the develop branch.
• The develop branch contains the latest code under active development. Once a new release is ready, the main branch will be updated by merging from the development branch.

Development Workflow

1. Fork the repository and create a feature branch from the develop branch.

   • Use descriptive names for your branches, e.g., feature/add-new-endpoint or bugfix/fix-connection-issue.

2. Make your changes in your feature branch.

3. Ensure all tests pass and the code follows the project’s style guidelines.

4. Open a Pull Request (PR) against the develop branch.

5. Your PR will be reviewed by maintainers. Please be responsive to feedback.

6. Once approved, the changes will be merged into the develop branch. A merge into the main branch will only occur when releasing a new version.

Project Dependencies

This project requires the following dependencies installed on your system:

• VSCode - To enter into the devcontainer
• Docker – For containerized environments.
• Docker Compose – To manage multi-container setups.

Development process

This project uses devcontainers to simplify the development, please refer to the following resources to learn more about devcontainers:

• https://containers.dev
• https://code.visualstudio.com/docs/devcontainers/containers
• https://www.youtube.com/watch?v=SDa3v4Quj7Y

How to Use Taskfile Commands

• To see all available commands, run:

  task --list
  

Additional Notes

• Always write clear commit messages that explain the purpose of your changes.
• Keep your fork up to date with the latest changes from the develop branch.
• Be respectful and follow the project’s code of conduct when interacting with other contributors.

We appreciate your contributions and are excited to have you on board!