Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
100 changes: 100 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
# 🎓 Welcome to the Genatio Contribution Guidelines! 🚀

Welcome to the Contribution Guidelines for the Preparation Practice project by Genatio! We appreciate your interest in contributing to our closed-source project. Your contributions will help us improve our product and provide a better learning experience for our users. Please follow the guidelines below to ensure smooth collaboration.

## Table of Contents

1. [Bug Reports and Feature Requests](#bug-reports-and-feature-requests)
2. [Setting Up Your Development Environment](#setting-up-your-development-environment)
3. [Code Style and Guidelines](#code-style-and-guidelines)
4. [Submitting Changes](#submitting-changes)
5. [Code Review](#code-review)
6. [Security Vulnerabilities](#security-vulnerabilities)
7. [Becoming a Maintainer](#becoming-a-maintainer)
8. [Join the Community](#join-the-community)

## Bug Reports and Feature Requests

We welcome bug reports and feature requests for the Preparation Practice project. To submit a bug report or request a new feature, please follow these steps:

1. Check the existing issues to avoid duplicates.
2. If the issue or feature request hasn't been reported yet, create a new issue with a clear and descriptive title.
3. Provide detailed information about the bug or feature request, including steps to reproduce the issue or a thorough explanation of the desired feature.

## Setting Up Your Development Environment

To contribute to the Preparation Practice project, follow these steps to set up your development environment:

1. Fork the project repository to your GitHub account.
2. Clone the forked repository to your local machine:

```shell
git clone https://github.com/<your-username>/<repository-name>.git
```

3. Set the upstream to the original repository:

```shell
git remote add upstream https://github.com/<Genatio>/<repository-name>.git
```

4. Create a new branch for the issue or feature you're working on:

```shell
git checkout -b <branch-name>
```

5. Make your changes to the codebase, ensuring they adhere to our code style and guidelines.
6. Test your changes locally to ensure they function as expected.
7. Commit your changes with a clear and descriptive commit message:

```shell
git commit -m "Fix issue #123: Add new feature"
```

8. Push your changes to your forked repository:

```shell
git push origin <branch-name>
```

9. Open a pull request to merge your changes into the main repository. Clearly describe the purpose and scope of your changes in the pull request.

## Code Style and Guidelines

Consistent code style and adherence to guidelines are essential for maintaining a clean and maintainable codebase. When contributing code, please follow these guidelines:

- Adhere to the existing code style and conventions used in the project.
- Maintain consistency with the project's architecture and development patterns.
- Write clear, self-explanatory code and use meaningful variable and function names.
- Document your code as necessary, providing explanations for complex logic or algorithms.

## Submitting Changes

When submitting changes to the Preparation Practice project, please ensure the following:

- Your changes are focused and address a specific bug or feature.
- Your code is thoroughly tested and does not introduce new bugs or regressions.
- Include relevant tests where applicable to validate your changes.
- Commit your changes with clear and descriptive commit messages.
- Push your changes to your forked repository and open a pull request.

## Code Review

Once you've submitted a pull request, our maintainers will review your changes. Please be patient during the review process, as it may take some time. You may be asked to make additional changes or address specific feedback before your changes are accepted.

## Security Vulnerabilities

If you discover a security vulnerability in the Preparation Practice project, please report it immediately by contacting us at [[email protected]](mailto:[email protected]). We take security vulnerabilities seriously and will work to address them as quickly as possible.

## Becoming a Maintainer

If you are interested in becoming a maintainer of the Preparation Practice project, please reach out to us at [[email protected]](mailto:[email protected]). We will consider candidates based on their contributions to the project, technical expertise, and commitment to maintaining a secure and high-quality codebase.

## Join the Community

We welcome all individuals interested in contributing to the Preparation Practice project. Join our community and help us create a powerful learning platform that empowers students worldwide. Connect with us on our official channels, participate in discussions, and collaborate with other contributors to make a positive impact.

Thank you for considering contributing to the Preparation Practice project. Your efforts are greatly appreciated, and we look forward to working with you!

Note: Please adapt the content and contact email addresses to match your company's guidelines and practices.