We appreciate your interest in contributing to Jackson, and your contributions are integral to enhancing the project. Whether addressing a bug, implementing new features, or suggesting improvements, your involvement is highly valued and essential.
- Contributing to Jackson
Please adhere to the Node Style Guide.
To get started, fork the Jackson repository. This creates a duplicate of the project, allowing you to make and test your changes without affecting the original project.
Clone your forked repository to your local development environment using this command:
git clone https://github.com/your-username/jackson.gitSee our README for instructions on setting up the project.
Begin by creating a new branch where you will work on your changes. You should always aim to start by creating an issue that describes the problem you are solving or the feature you are implementing. This will help ensure that the maintainers are aware of your work and can provide feedback.
Let's say that your issue title is "Support Custom Postgres Schema" and is issue number #1818. The ideal format for your branch name would be 1818-support-custom-postgres-schema.
You can create a new branch with the following command:
git switch -c 1818-support-custom-postgres-schemaFor older versions of Git, use:
git checkout -b 1818-support-custom-postgres-schemaUse the following command to stage the changes you want to commit:
git add your-file-nameAlternatively, you can stage all changes with:
git add .Make clear and concise commits with a descriptive message:
git commit -m "Enter a descriptive message for the changes to be committed"Once your changes are committed, push them to your branch:
git push origin your-branch-nameEffective pull requests, which can include patches, improvements, or new features, are a valuable contribution. Ensure they are focused on a specific scope and do not contain unrelated commits.
To create a pull request, navigate to the original repository on GitHub and click the "New Pull Request" button. Compare and create a pull request from your branch to the main repository. Provide a clear and concise description of your changes in the pull request.
After submitting your pull request, maintainers and other contributors will review your changes and provide feedback. Be prepared to address any suggested improvements.
Once your pull request is approved, it will be merged into the main branch of the project.
If you encounter any issues or bugs, please report them with detailed information to aid in troubleshooting.
Feel free to submit detailed feature requests for new functionality you would like to see.
Comprehensive testing of your changes is vital to prevent regressions and errors.
To begin your contribution journey, explore our list of "good first issue" tasks specifically curated for newcomers and first-time contributors.
- Fork the repository.
- Clone your fork to your local environment.
- Install dependencies.
- Implement changes, add features, or enhance documentation.
- Test your changes.
- Submit a pull request against the main branch.
Please ensure that your contributions align with our Code of Conduct. Show respect, inclusivity, and consideration for others.
Jackson is an open-source project released under the Apache License 2.0. Your contributions are subject to the terms of this license.
- Be patient. Your contributions are important, and we will do our best to review them in a timely manner.
- Be responsive to feedback from maintainers.
- Don't hesitate to seek help if needed in the discussion forum or any related platform.
Happy contributing!