|
| 1 | +# Contributing to MarkLogic-docker |
| 2 | + |
| 3 | +Thank you for your interest in contributing to this project! We welcome contributions from the community to make this project better. |
| 4 | + |
| 5 | +- [Found an Issue](#found-an-issue) |
| 6 | +- [Want a Feature](#want-a-feature) |
| 7 | +- [Getting Started](#getting-started) |
| 8 | +- [Issue Tracker](#issue-tracker) |
| 9 | +- [PR management](#pr-management) |
| 10 | +- [Code Style](#code-style) |
| 11 | + |
| 12 | +## Found an Issue? |
| 13 | + |
| 14 | +If you find a bug in the source code or a mistake in the documentation, you can help us by submitting an issue |
| 15 | +to our [GitHub Issue Tracker][Issue Tracker]. If you'd like to submit a feature enhancement, please first create an |
| 16 | +issue with your proposed idea so that we can start a discussion about the problem you want to solve and what the best |
| 17 | +solution would be. |
| 18 | + |
| 19 | +## Want a Feature? |
| 20 | + |
| 21 | +You can request a new feature by submitting an issue to our [GitHub Issue Tracker][Issue Tracker]. If you |
| 22 | +would like to implement a new feature then first create a new issue and discuss it with one of our |
| 23 | +project maintainers. |
| 24 | + |
| 25 | +## Getting Started |
| 26 | + |
| 27 | +To get started with contributing, please follow these steps: |
| 28 | + |
| 29 | +1. Fork the repository and clone it to your local machine. |
| 30 | +2. Install the necessary dependencies. |
| 31 | +3. Create a new branch for your changes. |
| 32 | +4. Make your desired changes to the codebase. |
| 33 | +5. Test your changes thoroughly. |
| 34 | +6. Tests can be done using the test framework. See [README](./test/README.md) |
| 35 | + |
| 36 | +## Issue Tracker |
| 37 | + |
| 38 | +If you encounter any issues or have suggestions for improvements, please open an issue in the issue tracker. Be sure to provide as much detail as possible, including steps to reproduce the issue if applicable. |
| 39 | + |
| 40 | +## PR management |
| 41 | + |
| 42 | +Created PR will not be merge as is. |
| 43 | +The MarkLogic docker team will use the PRs for "inspiration" but not merge the changes in directly. They may rewrite the code as they like, incorporating the submitted changes into their own code. |
| 44 | + |
| 45 | +**Important:** Please open an issue in the [Issue Tracker][] and get your proposed changes pre-approved by at least one of the project maintainers before you start coding. Nothing is more frustrating than seeing your hard work go to waste because your vision does not align with that of the project maintainers. |
| 46 | + |
| 47 | +## Code Style |
| 48 | + |
| 49 | +Please follow the established code style guidelines when making changes to the codebase. This ensures consistency and makes it easier for others to review and maintain the code. |
| 50 | + |
| 51 | +[Issue Tracker]: https://github.com/marklogic/marklogic-docker/issues |
0 commit comments