mirror of
https://github.com/OpenSignLabs/OpenSign.git
synced 2026-08-21 23:22:35 +02:00
Update intro.md
This commit is contained in:
@@ -2,46 +2,84 @@
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# Tutorial Intro
|
||||
# Contributing to OpenSign
|
||||
|
||||
Let's discover **Docusaurus in less than 5 minutes**.
|
||||
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
|
||||
|
||||
Get started by **creating a new site**.
|
||||
- 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.
|
||||
|
||||
Or **try Docusaurus immediately** with **[docusaurus.new](https://docusaurus.new)**.
|
||||
## Code of Conduct
|
||||
|
||||
### What you'll need
|
||||
We expect all our contributors to adhere to the [Code of Conduct](CODE_OF_CONDUCT.md). Please read it thoroughly before contributing.
|
||||
|
||||
- [Node.js](https://nodejs.org/en/download/) version 18.0 or above:
|
||||
- When installing Node.js, you are recommended to check all checkboxes related to dependencies.
|
||||
## How Can I Contribute?
|
||||
|
||||
## Generate a new site
|
||||
### Reporting Bugs
|
||||
|
||||
Generate a new Docusaurus site using the **classic template**.
|
||||
- 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.
|
||||
|
||||
The classic template will automatically be added to your project after you run the command:
|
||||
### Suggesting Enhancements
|
||||
|
||||
```bash
|
||||
npm init docusaurus@latest my-website classic
|
||||
```
|
||||
- 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.
|
||||
|
||||
You can type this command into Command Prompt, Powershell, Terminal, or any other integrated terminal of your code editor.
|
||||
### Pull Requests
|
||||
|
||||
The command also installs all necessary dependencies you need to run Docusaurus.
|
||||
- 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.
|
||||
|
||||
## Start your site
|
||||
## Style Guidelines
|
||||
|
||||
Run the development server:
|
||||
### Git Commit Messages
|
||||
|
||||
```bash
|
||||
cd my-website
|
||||
npm run start
|
||||
```
|
||||
- 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
|
||||
|
||||
The `cd` command changes the directory you're working with. In order to work with your newly created Docusaurus site, you'll need to navigate the terminal there.
|
||||
### JavaScript Style Guide
|
||||
|
||||
The `npm run start` command builds your website locally and serves it through a development server, ready for you to view at http://localhost:3000/.
|
||||
Adhere to the [Standard JavaScript Style Guide](https://standardjs.com).
|
||||
|
||||
Open `docs/intro.md` (this page) and edit some lines: the site **reloads automatically** and displays your changes.
|
||||
## 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 [MIT License](LICENSE).
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user