mirror of
https://github.com/OpenSignLabs/OpenSign.git
synced 2026-08-17 21:25:54 +02:00
83 lines
4.2 KiB
Markdown
83 lines
4.2 KiB
Markdown
|
||
# Contributing to OpenSign
|
||
|
||
Hello there! Thank you for considering contributing to OpenSign, the open-source alternative to DocuSign. OpenSign is not just a project, but a community endeavor that aims to create a robust, user-friendly, and secure electronic signature solution. Your contributions, irrespective of their size, are valuable in making this vision a reality.
|
||
|
||
## Hacktoberfest at OpenSign
|
||
|
||
We are excited to announce that OpenSign is participating in Hacktoberfest! Hacktoberfest is a month-long celebration of open source where contributors can earn swag by contributing to open source projects. It's a fantastic opportunity to contribute, learn, and engage with the community. We welcome contributions of all kinds, and we are looking forward to seeing your contributions!
|
||
|
||
### Hacktoberfest Guidelines
|
||
|
||
1. **Registration:** Ensure you have signed up for [Hacktoberfest](https://hacktoberfest.digitalocean.com/) before making contributions to qualify for rewards.
|
||
2. **Quality Standards:** Substantial contributions are encouraged. PRs with minor text edits or that are deemed as low effort by maintainers may be marked as "invalid" or "spam".
|
||
3. **Pull Requests:** Only pull requests submitted between October 1st and October 31st will count towards the event.
|
||
4. **Respect:** Adhere to our [Code of Conduct](CODE_OF_CONDUCT.md) and maintain a respectful and collaborative environment.
|
||
|
||
## Table of Contents
|
||
|
||
1. [Getting Started](#getting-started)
|
||
2. [Code of Conduct](#code-of-conduct)
|
||
3. [How Can I Contribute?](#how-can-i-contribute)
|
||
- [Reporting Bugs](#reporting-bugs)
|
||
- [Suggesting Enhancements](#suggesting-enhancements)
|
||
- [Pull Requests](#pull-requests)
|
||
4. [Style Guidelines](#style-guidelines)
|
||
- [Git Commit Messages](#git-commit-messages)
|
||
- [JavaScript Style Guide](#javascript-style-guide)
|
||
5. [Community](#community)
|
||
6. [License](#license)
|
||
|
||
## Getting Started
|
||
|
||
- Fork the [OpenSign repository](https://github.com/OpenSignLabs/OpenSign) to your GitHub account.
|
||
- Clone your fork locally: `git clone https://github.com/your-username/OpenSign.git`
|
||
- Create a new branch for your contribution: `git checkout -b feature/your-feature-name`
|
||
- Make your contributions.
|
||
- Push your branch to your fork: `git push origin feature/your-feature-name`
|
||
- Create a Pull Request from your fork to the OpenSign repository.
|
||
|
||
## Code of Conduct
|
||
|
||
We expect all our contributors to adhere to the [Code of Conduct](CODE_OF_CONDUCT.md). Please read it thoroughly before contributing.
|
||
|
||
## How Can I Contribute?
|
||
|
||
### Reporting Bugs
|
||
|
||
- Check the [Issues](https://github.com/OpenSignLabs/OpenSign/issues) to see if the bug has already been reported. If it has, add any additional information in the comments.
|
||
- If the bug hasn’t been reported, create a new issue. Please provide as much information as possible to help maintainers reproduce the bug.
|
||
|
||
### Suggesting Enhancements
|
||
|
||
- Use the [Issues](https://github.com/OpenSignLabs/OpenSign/issues) section to suggest any enhancements or new features.
|
||
- Clearly describe your suggestion, explaining the problem it solves or the functionality it adds.
|
||
|
||
### Pull Requests
|
||
|
||
- Ensure any install or build dependencies are removed before the end of the layer when doing a build.
|
||
- Update the README.md with details of changes to the interface, this includes new environment variables, exposed ports, useful file locations, and container parameters.
|
||
- You may merge the Pull Request in once you have the sign-off of two other developers, or if you do not have permission to do that, you may request the second reviewer to merge it for you.
|
||
|
||
## Style Guidelines
|
||
|
||
### Git Commit Messages
|
||
|
||
- Use the present tense ("Add feature" not "Added feature")
|
||
- Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
|
||
- Limit the first line to 72 characters or less
|
||
|
||
### JavaScript Style Guide
|
||
|
||
Adhere to the [Standard JavaScript Style Guide](https://standardjs.com).
|
||
|
||
## Community
|
||
|
||
Engage with the community on our [Gitter Channel](https://gitter.im/OpenSignLabs/community) or join our monthly community calls. Details can be found on our [Community Page](COMMUNITY.md).
|
||
|
||
## License
|
||
|
||
By contributing, you agree that your contributions will be licensed under its [AGPL-V3 License](LICENSE).
|
||
|
||
---
|