Create contributing.md

pull/26/head
lightningRalf 2023-04-16 04:35:37 +02:00 zatwierdzone przez GitHub
rodzic c62643e4ac
commit cad307fc69
Nie znaleziono w bazie danych klucza dla tego podpisu
ID klucza GPG: 4AEE18F83AFDEB23
1 zmienionych plików z 63 dodań i 0 usunięć

63
.github/contributing.md vendored 100644
Wyświetl plik

@ -0,0 +1,63 @@
# Contributing to Wolverine
First of all, thank you for your interest in contributing to Wolverine! We appreciate the time and effort you're willing to invest in making our project better. This document provides guidelines and information to make the contribution process as smooth as possible.
## Table of Contents
- [Code of Conduct](#code-of-conduct)
- [Getting Started](#getting-started)
- [How to Contribute](#how-to-contribute)
- [Reporting Bugs](#reporting-bugs)
- [Suggesting Enhancements](#suggesting-enhancements)
- [Submitting Pull Requests](#submitting-pull-requests)
- [Style Guidelines](#style-guidelines)
- [Code Style](#code-style)
- [Commit Messages](#commit-messages)
- [Additional Resources](#additional-resources)
## Code of Conduct
All contributors are expected to adhere to our [Code of Conduct](CODE_OF_CONDUCT.md). Please read it before participating in the Wolverine community.
## Getting Started
1. Fork the repository and clone it to your local machine.
2. Set up the development environment by following the instructions in the [README.md](README.md) file.
3. Explore the codebase, run tests, and verify that everything works as expected.
## How to Contribute
### Reporting Bugs
If you encounter a bug or issue while using Wolverine, please open a new issue on the [GitHub Issues](https://github.com/biobootloader/wolverine/issues) page. Provide a clear and concise description of the problem, steps to reproduce it, and any relevant error messages or logs.
### Suggesting Enhancements
We welcome ideas for improvements and new features. To suggest an enhancement, open a new issue on the [GitHub Issues](https://github.com/biobootloader/wolverine/issues) page. Describe the enhancement in detail, explain the use case, and outline the benefits it would bring to the project.
### Submitting Pull Requests
1. Create a new branch for your feature or bugfix. Use a descriptive name like `feature/your-feature-name` or `fix/your-bugfix-name`.
2. Make your changes, following the [Style Guidelines](#style-guidelines) below.
3. Test your changes and ensure that they don't introduce new issues or break existing functionality.
4. Commit your changes, following the [commit message guidelines](#commit-messages).
5. Push your branch to your fork on GitHub.
6. Open a new pull request against the `main` branch of the Wolverine repository. Include a clear and concise description of your changes, referencing any related issues.
## Style Guidelines
### Code Style
Wolverine uses [PEP 8](https://www.python.org/dev/peps/pep-0008/) as its code style guide. Please ensure that your code follows these guidelines. We recommend using a linter like [flake8](https://flake8.pycqa.org/en/latest/) to check your code style before committing.
### Commit Messages
Write clear and concise commit messages that briefly describe the changes made in each commit. Use the imperative mood and start with a capitalized verb, e.g., "Add new feature" or "Fix bug in function".
## Additional Resources
- [GitHub Help](https://help.github.com/)
- [GitHub Pull Request Documentation](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests)
- [PEP 8 Style Guide](https://www.python.org/dev/peps/pep-0008/)
Thank you once again for your interest in contributing to Wolverine. We look forward to collaborating with you and creating an even better project together!