-
Notifications
You must be signed in to change notification settings - Fork 140
Open
Labels
Description
-
Problem Description:
- Contributors need clear guidance on the steps to follow and tests to perform before making a pull request to ensure a smooth and effective contribution process.
-
Steps to Reproduce:
- N/A
-
Expected Behavior:
- Provide contributors with a comprehensive checklist outlining the necessary steps to take before submitting a pull request.
-
Current Behavior:
- Contributors might be uncertain about the specific requirements and steps to follow when making a contribution.
-
Proposed Changes:
- Create a contribution checklist that includes steps for code changes, testing procedures, and considerations for local and Docker/Kubernetes environments.
- Include details on setting up a local development environment, running tests, and ensuring compatibility with both Docker API and Kubernetes.
-
Dependencies:
- Clear documentation on the project's structure, development environment setup, and testing procedures.
-
Testing:
- Test the contribution checklist with a new contributor to ensure its clarity and effectiveness.
- Validate that contributors can successfully follow the steps and guidelines.
-
Documentation Updates:
- Add the contribution checklist to the project's documentation.
- Provide explanations and context for each item on the checklist.
- Specify how contributors can run tests locally and what behavior to expect.
-
Expected Impact:
- The contribution checklist will streamline the pull request process, reducing ambiguity for contributors and improving the overall quality of contributions.
-
Additional Information:
- Include details on how to address common issues or challenges that contributors might face.
- Encourage contributors to seek assistance through designated communication channels (e.g., discussion forums, chat) if they encounter difficulties.
Example Checklist for Contributors:
-
Local Development:
- Set up a local development environment by following the documentation.
- Ensure that the code changes are compatible with both Docker API and Kubernetes.
-
Code Changes:
- Follow the project's coding conventions and style guidelines.
- Test the changes thoroughly to address the intended functionality.
-
Tests:
- Run existing unit tests and ensure they pass.
- Create new tests for the added functionality or bug fix.
- Test the changes in both local and Docker/Kubernetes environments.
-
Documentation:
- Update or create documentation for any new features or changes.
- Ensure that the README and other relevant documentation is accurate and up-to-date.
-
Pull Request:
- Create a clear and descriptive pull request.
- Provide context on the changes made and the problem addressed.
- Mention any dependencies or related issues.
Note: Regularly review and update the checklist based on changes in the project's development and testing processes.