Hi! Welcome to contribute to Ink UI! Before submitting your contribution, please take a moment to read the following guidelines:
I usually prefer to keep a whole meaningful commit history, so if you think the same,
I suggest you follow the following conventions when committing:
- We use
emojito identify the type ofcommit, which helps us understand the purpose of eachcommitbetter- You can refer to gitmoji for usage
- Specifically, when upgrading a feature, we prefer to use
🚀to indicate an upgrade feeling
- We use
[]to identify the specific scope of changes, such as[button], to better understand the scope of each commit
Here is an example:
🎉 [init] init project
Or you can look at the current commit history to learn more.
Of course, you can also keep your own commit style, then I will merge your commit history.
- Please make sure the content you changed has passed the test cases.
- Please describe the changes in detail, considering the uniqueness of
Shuimo UI, if it's not a bug fix, we prefer to have a priorissuediscussion to determine the direction of the modification. - If it involves changes to the documentation, please modify the documentation content accordingly.
Forkthe repository to your own accountCloneyour repository to local- Use
pnpm ito install dependencies- If you are willing to follow the
commitspecification ofshuimoand want to uselint, then you can update thepreparecommand inpackage.jsonand reinstall the.huskydependency:{ "scripts": { "prepare": "jhlint install -u -p" } }
- If you are willing to follow the
- Then you can use
playgroundfor developmentpnpm run dev
- After development, you need to build first
Then check the components in
pnpm run build
docand update the documentation.
Finally, thank you very much for your reading and contribution!
Hi! 欢迎你对水墨UI做出贡献!在提交你的贡献之前,请花一点时间阅读以下指南:
通常我更愿意留下一整段有意义的commit记录,因此我建议如果你也是这么想的,
那么希望你可以在commit时可以遵循以下规范:
- 我们使用
emoji来标识commit的类型,这样可以让我们更好的知道每次commit的目的- 你可以参照gitmoji来使用
- 特别的,在升级某个功能的时候,我们会更倾向使用
🚀来标识,给人一种升级的感觉
- 我们会使用
[]来标识具体更改了哪个范围的东西,比如[Button],这样可以让我们更好的知道每次commit的范围
以下是一个例子:
🎉 [init] init project
亦或者你可以查看现在的commit记录来了解更多。
当然,你也可以保持你自己的commit风格,那我将会合并你的commit记录。
- 请务必保证您改动的内容通过了测试用例。
- 请尽量详细地描述改动内容,鉴于
水墨ui的特殊性,如果不是bug修复,我们更希望有前置的issue讨论以确定修改方向。 - 如果涉及到了文档的变动,请同步修改文档内容。
- 将仓库
fork到自己的账户下 clone自己的仓库到本地- 使用
pnpm i安装依赖- 如果您愿意遵循
shuimo的commit规范,并且希望使用lint,那么您可以更新package.json中的prepare命令,重新安装.husky依赖:{ "scripts": { "prepare": "jhlint install -u -p" } }
- 如果您愿意遵循
- 然后您可以使用
playground来进行开发pnpm run dev
- 开发完成后,您需要先build
然后在
pnpm run build
doc中查看组件,更新文档。
最后,非常感谢您的阅读和贡献!