From 2ed6b40cc40cbad3c9136d0b308379b47b3c02da Mon Sep 17 00:00:00 2001 From: fracappa Date: Fri, 14 Jun 2024 12:04:13 +0200 Subject: [PATCH] adding Contributing section solving linting problems solving linting problems solving linting problems adding a comment about squashing commits --- CONTRIBUTING.md | 52 +++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 4 ++++ 2 files changed, 56 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..ca358ad --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,52 @@ +# Contributing to FLUIDOS Node # + +First of all, thank you for your time! + +This section provides guidelines and suggestions for the local development of FLUIDOS Node components. + +## Local development ## + +To better articulate the process, here's a refined version: + +When developing a new feature, it is beneficial to test changes in a local environment and debug the code to identify potential issues. To facilitate this, you can use the provided setup.sh script for the quick start example. This script helps you create two development clusters using KinD and install FLUIDOS Node along with its dependencies on both clusters. + +To get started, follow these steps: + +1. Run the `/tools/scripts/setup.sh` script. + When prompted, choose the type of environment: + - Select option 1 for one consumer and one provider cluster. + - Select option 2 for an environment with multiple consumers and providers. +2. Confirm with "yes" when asked if you want to use local repositories. + +## How to contribute ## + +We welcome contributions to the project! To ensure a smooth process, please follow these steps: + +1. ### Open a issue ### + + When reporting a bug, requesting a new feature, or suggesting documentation improvements, please use the appropriate labels: + - **bug** for reporting a bug + - **enhancement** for a new feature + - **documentation** for documentation improvements + +2. ### Fork the Repository ### + + Create your own copy of the repository. + +3. ### Create a New Branch ### + + It is recommended to create a new branch in your fork to work on the requested modifications. + +4. ### Merge Modifications ### + + After making the necessary changes, merge them into your fork's main branch. Ensure you have rebased your branch from the remote upstream repository. + +5. ### Test and Resolve Conflicts ### + + Test your changes thoroughly and resolve any potential merge conflicts. + +6. ### Open a Pull Request (PR) ### + + Once your modifications are tested and conflicts are resolved, open a PR to the main repository. Remember to squash all your commits during the PR. + +Thank you for your contributions! diff --git a/README.md b/README.md index 4bbb693..845c0a6 100644 --- a/README.md +++ b/README.md @@ -35,3 +35,7 @@ Want to know how to install a FLUIDOS Node? Check out the [**Installation**](./d ## License This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details. + +## How to Contribute + +Please, refer to the [Contributing](CONTRIBUTING.md) guide on how to contribute.