Thank you very much for your interest in contributing to this project! To make the contribution process as smooth as possible, please follow the guidelines below.
First, fork the repository to your GitHub account. This will create your own copy of the repository.
Clone the repository you just forked to your local machine:
git clone https://github.com/your-username/repository-name.git
cd repository-name
To keep your repository in sync with the original repository, add the upstream remote:
git remote add upstream https://github.com/xun082/online-edit-web.git
Before you start working, make sure to create a new branch:
git checkout -b feature/your-branch-name
Before you start developing, install all dependencies:
pnpm install
To ensure you are developing in a properly running environment, start the project:
pnpm dev
To conveniently use and test your scaffold commands during development, you can globally link your project using pnpm link --global
:
pnpm link --global
If using npm link
, the command is:
npm link
This way, you can use your scaffold commands anywhere without having to run them from the project directory each time.
Please follow these development guidelines:
- Ensure code is clear and concise.
- Follow the project's code style and standards (you can use ESLint and Prettier).
- If you add new features, please write corresponding tests.
- If you fix bugs, please add tests to prevent them from reoccurring.
Before committing your changes, make sure you have properly formatted and linted the code:
pnpm lint
pnpm format
Then commit your changes:
git add .
git commit -m "Clear and descriptive commit message"
Before you submit your changes, make sure your branch is up to date:
git fetch upstream
git rebase upstream/main
Push your branch to your own repository:
git push origin feature/your-branch-name
On GitHub, navigate to your forked repository and click the "Compare & pull request" button. Make sure to describe your changes in detail.
All Pull Requests will be reviewed. Please keep the following points in mind:
- Is your code clear and easy to understand?
- Have you followed the project's code style and standards?
- Have you added appropriate tests?
- Are your changes compatible with the existing code?
If you find a bug, please create an issue on GitHub and describe the bug and the steps to reproduce it as detailed as possible.
If you have a suggestion for a new feature, please create an issue on GitHub and describe your suggestion and its potential use in detail.
If you have any questions or need help, please feel free to contact us via email at [email protected]
or WeChat yunmz777
, or ask on GitHub.