Skip to content

Latest commit

 

History

History
104 lines (78 loc) · 4.24 KB

CONTRIBUTING-zh-CN.md

File metadata and controls

104 lines (78 loc) · 4.24 KB
Raw

贡献

使用其他语言来阅读本文档: English / 日本語 / Español / Português / 한국어

你打算为本项目做贡献？太棒了！

需要知道的事情

本项目与参与者行为准则保持一致. 我们期望你在参与本项目的时候也赞同并支持该行为准则. 关于报告不可接受的行为，请参考我们的行为准则.

在忙于你的第一个PR吗? 如何在GitHub上面为开源项目做贡献

如何

搭建项目

你有想为我们的项目做贡献，我们真的很高兴! ❤️ 请参考如下的步骤开始吧:

  1. Fork 并且 clone 我们的代码仓库
  2. 安装必须的依赖: 
    $ npm install
  3. 启动开发服务器:
    To view all available components in an interactive interface, use storybook. 
    $ npm run storybook

目录结构

.
├── index.html: Demo page
├── style.css: Demo page style
├── css: Distribution files
├── docs: Storybook stories
└── scss: Source
    ├── base
    │   ├── reboot.scss: Don't change! (Bootstrap Reboot)
    │   ├── generic.scss: Generic style and reboot.css
    │   └── variables.scss: Common variables
    ├── elements
    ├── components
    ├── form
    ├── icons: 16x16 icons
    ├── pixel-arts: For icons other than 16x16.
    └── utilities

小建议: 确保你的 master 分支指向原始的代码仓库并且从你fork的分支上创建PR. 请按如下命令进行操作:

git remote add upstream https://github.com/nostalgic-css/NES.css.git
git fetch upstream
git branch --set-upstream-to=upstream/master master

这样就会把原始的代码仓库添加为一个名为"upstream"的远程连接,并且从这个远程的仓库连接获取git的信息, 然后当你运行git pull命令的时候会指定本地的master分支去使用upstream/master分支. 在这个时候, 你就能基于这个master 分支来创建所有你自己的分支. 当你想更新你的master的版本信息的时候, 执行一个常规的git pull命令即可.

nostalgic-css 组织如何为项目做贡献

nostalgic-css 组织的成员必须遵守如下的步骤. 外部的贡献者只需要遵守以上的准则即可.

开发步骤

  1. 使用下面的格式化规则从develop分支来创建自己的分支。
  2. 做满足问题要求的必要的工作。如果发现你的工作跟该问题无关，请创建一个新的问题并且在另外一个分支在进行你的工作。
  3. 提交你的PR然后合并回develop分支.
    • 任何影响当前开发的改变都必须在文档里面描述清楚.
    • 跟某一问题相关的PRs必须把那个问题的号码标注在标题里. 比如: [#33] Fix bug
    • 分配一个问题给你自己.
    • 当这个问题准备合并的时候, 必须向nostalgic-css/NES.css 小组申请审核.
  4. 一旦PR被批准了，接下来合并分支的更改就是被分配者的义务了。

提交格式化

我们使用Commitizen 以及 commitlint 来确保所有的项目提交都是易于阅读的, 并且使用 semantic-release 来确保我们的发布是自动化的, 不浪漫的以及不带情感色彩的.