Thank you for considering contributing to Argoflows! We value and appreciate contributions of all kinds, including bug fixes, feature enhancements, documentation improvements, and more. This guide outlines the process to ensure your contributions are effective and impactful.
To begin contributing:
-
Fork the repository: Click the "Fork" button at the top of this repository.
-
Clone your fork: Use below command to clone the repository.
git clone https://github.com/your-username/argoflows.git.
-
Create a branch: Use a descriptive branch name, such as
feature/add-new-feature
orbugfix/fix-issue
. -
Make changes: Implement your changes in the new branch.
-
Test your changes: Verify that your changes work as intended.
-
Submit a pull request: Open a pull request (PR) to the main repository for review.
If you encounter a bug or have a suggestion, check the issue tracker
to see if it has already been reported. If not, open a new issue and provide:
-
A clear and descriptive title.
-
Steps to reproduce the issue (if applicable).
-
Expected and actual results.
-
Relevant screenshots, logs, or additional context.
We encourage feature suggestions! Open an issue labeled enhancement
and include:
-
A detailed description of the feature.
-
The problem it solves or the use case it addresses.
-
Relevant examples, references, or mockups (if applicable).
To contribute code:
-
Choose an issue labeled
good first issue
orhelp wanted
from the issue tracker. -
Comment on the issue to indicate that you are working on it.
-
Follow the Setup Instructions to run the project locally.
-
Make your changes and thoroughly test them.
-
Submit a pull request with a detailed description of your changes and their purpose.
Adhere to the following coding standards to maintain consistency:
-
Use
Prettier
for code formatting. -
Follow the existing code style and structure.
-
Write clear, concise, and descriptive commit messages (e.g., "Fix: Resolve issue with login timeout").
-
Add comments for complex or non-obvious code to improve readability.
-
Ensure your code is thoroughly tested and follows the project’s style guidelines.
-
Write a clear and descriptive PR title and description, referencing related issues (e.g., "Closes #14").
-
Ensure your branch is
up-to-date
with themain
branch. -
Submit your PR and address any feedback from reviewers promptly.
-
Once approved, your PR will be merged into the main branch.
If you have questions or need assistance, you can:
- Start a discussion in the
GitHub Discussions
.
Your contributions make Argoflows better for everyone. Thank you for your support and involvement!