Skip to content

Commit

Permalink
📃 docs(contributing): update contributing.md
Browse files Browse the repository at this point in the history
  • Loading branch information
bingling-sama committed Jul 29, 2024
1 parent ef15f04 commit afe6d30
Show file tree
Hide file tree
Showing 4 changed files with 26 additions and 51 deletions.
2 changes: 1 addition & 1 deletion docs/blog/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ editor: bingling-sama

## 关于文章

本博客文章均由 GlobeMC 团队及其成员撰写或约稿,所有内容由其实际具体撰写人负责,仅代表作者观点,如有谬误及不当处望海涵,可以在文章下评论区提出或发送电邮至编辑部部长邮箱<[email protected]>
本博客文章均由 GlobeMC 团队及其成员撰写或约稿,所有内容由其实际具体撰写人负责,仅代表作者观点,如有谬误及不当处望海涵,可以在文章下评论区提出或发送电邮至编辑部部长邮箱 <[email protected]>

有意为 CrashMC Blog 供稿的话也可以电邮联系编辑部部长。

Expand Down
24 changes: 20 additions & 4 deletions docs/contribute/contributing.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
contributors: [HRxiaohu, bingling-sama]
editor: bingling-sama
---

# 贡献指南
Expand All @@ -13,7 +13,7 @@ contributors: [HRxiaohu, bingling-sama]
```bash
# 推荐使用 SSH
git clone [email protected]:{yourname}/crashmc.com.git
# 也可以使用 HTTPS (不推荐)
# 也可以使用 HTTPS
git clone https://github.com/{yourname}/crashmc.com.git
```

Expand All @@ -29,7 +29,7 @@ git clone https://github.com/{yourname}/crashmc.com.git

### 文档内容

本文档按 [W3C Requirement for Chinese Text Layout](https://www.w3.org/International/clreq/) 进行排版,在贡献内容时请注意排版格式。
本文档按 [W3C Requirement for Chinese Text Layout][textlayoutdoc] 进行排版,在贡献内容时请注意排版格式。

在涉及任何站外链接时,请优先添加官方链接,尽量避免不必要的第三方链接。

Expand All @@ -53,9 +53,20 @@ git clone https://github.com/{yourname}/crashmc.com.git

文档会自动记录每个页面的 Git 提交历史记录以及为此文件做过贡献的人员,并将这些信息显示在页面上。

如果您发起或主导了某篇文章的编写,可以在 frontmatter 中署名,文末将会显示您的 GitHub 头像和地址,便于读者提出意见与后期可能存在的文章修改及版权相关事宜。

```
---
editor: username <!-- GitHub Username -->
---
```

如您不愿意署名,忽略此条提示即可,文末将署名为 CrashMC 编辑部部长 @bingling-sama

:::warning 警告

- 如果在多次提交时使用的名称不一致会导致贡献者记录中出现多个记录,建议统一自己提交时使用的名称。
- 如果已经出现了重复的贡献者记录,可以联系 CrashMC 工作人员进行处理。
- 上述代码中所使用的均为**英文半角逗号**

:::
Expand All @@ -64,9 +75,11 @@ git clone https://github.com/{yourname}/crashmc.com.git

如果您参与了代码内容的修改,~~相信您应该多少懂一些贡献流程,~~ 这里不再过多赘述贡献流程。

要注意的是,在准备 commit 之前,请运行 `docs:check` 任务来检查并格式化代码。

## Step.3 提交更改

在完成内容编写以后,请将您的所有更改 commit 到您的 fork 下,再向 [这里](https://github.com/GlobeMC/crashmc.com/tree/dev) 提交 PR。
在完成内容编写以后,请将您的所有更改 commit 到您的 fork 下,再向 [这里][prbranch] 提交 PR。

:::warning 重要提醒
请务必将您的更改 PR 到 `dev` barnch,以便我们审查排版及合并冲突。
Expand All @@ -89,3 +102,6 @@ git clone https://github.com/{yourname}/crashmc.com.git
## 鸣谢

感谢所有为 CrashMC 贡献内容的玩家和开发者,你们的支持是对 CrashMC 最大的鼓励。

[textlayoutdoc]: https://www.w3.org/International/clreq/
[prbranch]: https://github.com/GlobeMC/crashmc.com/tree/dev
10 changes: 5 additions & 5 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,11 +14,11 @@ hero:
text: 崩溃分析工具
link: /analyzer
- theme: alt
text: 客户端崩溃
link: /client/
text: 基础知识
link: /basis
- theme: alt
text: 服务器崩溃
link: /server/
text: 博客文章
link: /blog/

features:
- title: 方便
Expand All @@ -39,7 +39,7 @@ features:
icon: 🔌
details: 得益于 PWA(渐进式网页应用)技术,即使没有网络也可以查阅
- title: 周到
icon: 🫡
icon: 🤗
details: 我们知道只有冗长的文档还不够,因此我们准备了一个分析工具给大家
link: /analyzer.html
linkText: 开始使用
Expand Down
41 changes: 0 additions & 41 deletions pnpm-lock.yaml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

0 comments on commit afe6d30

Please sign in to comment.