From 5fcd41b527c0cf9556a7cfaa4c06de6f771f3a39 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=9B=AA=E5=B1=B1=E5=87=8C=E7=8B=90?= <1277510+xueshanlinghu@user.noreply.gitee.com> Date: Wed, 4 Nov 2020 18:49:28 +0800 Subject: [PATCH] =?UTF-8?q?update=20=E7=AC=AC=E4=B8=89=E9=83=A8=E5=88=86?= =?UTF-8?q?=E2=80=94=E2=80=94=E5=B0=9D=E8=AF=95=E5=8F=82=E4=B8=8E=E5=BC=80?= =?UTF-8?q?=E6=BA=90/=E6=8F=90=E4=BA=A4=E7=AC=AC=E4=B8=80=E4=B8=AA=20Issue?= =?UTF-8?q?.md.=20=E7=AC=AC=E5=9B=9B=E7=A8=BF=EF=BC=8C=E8=AF=A6=E8=A7=81?= =?UTF-8?q?=E6=89=A9=E5=B1=95=E4=BF=A1=E6=81=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...\254\254\344\270\200\344\270\252 Issue.md" | 23 ++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git "a/\347\254\254\344\270\211\351\203\250\345\210\206\342\200\224\342\200\224\345\260\235\350\257\225\345\217\202\344\270\216\345\274\200\346\272\220/\346\217\220\344\272\244\347\254\254\344\270\200\344\270\252 Issue.md" "b/\347\254\254\344\270\211\351\203\250\345\210\206\342\200\224\342\200\224\345\260\235\350\257\225\345\217\202\344\270\216\345\274\200\346\272\220/\346\217\220\344\272\244\347\254\254\344\270\200\344\270\252 Issue.md" index 0bee3cd..17afcef 100644 --- "a/\347\254\254\344\270\211\351\203\250\345\210\206\342\200\224\342\200\224\345\260\235\350\257\225\345\217\202\344\270\216\345\274\200\346\272\220/\346\217\220\344\272\244\347\254\254\344\270\200\344\270\252 Issue.md" +++ "b/\347\254\254\344\270\211\351\203\250\345\210\206\342\200\224\342\200\224\345\260\235\350\257\225\345\217\202\344\270\216\345\274\200\346\272\220/\346\217\220\344\272\244\347\254\254\344\270\200\344\270\252 Issue.md" @@ -47,7 +47,7 @@ Issue 的翻译大致为**议题**、**问题**。 1. 提问使用的语言 ：第一，参照维护者的母语，如果仓库所有者的母语是中文则建议优先母语交流。第二，如果不清楚应该使用什么语言，建议选择英文交流。 2. 提问态度和语气 ：因为你面对的是跟你一样的开发者，不卑不亢，虚心求教就可以了，不必要太咋呼，措辞太夸张等。但是语气之中要表示对作者的尊重，最好多使用`请`、`谢谢`、`please`、`thanks`等词语。 -3. **如有Issue模板，请参照模板写Issue**。如果原作者定义了 Issue 模板，请按模板来写，避免挤牙膏式的交流。如没有，本文会有比较通用的模板提供给大家。总之，撰写的原则是，把事情表述清楚，便于与原作者进行交流。 +3. **如有 Issue 模板，请参照模板写 Issue**。如果原作者定义了 Issue 模板，请按模板来写，避免挤牙膏式的交流。如没有，本文会有比较通用的模板提供给大家。总之，撰写的原则是，把事情表述清楚，便于与原作者进行交流。 #### 一个好 Issue 的标准[2] @@ -58,7 +58,7 @@ Issue 的翻译大致为**议题**、**问题**。 5. 问题足够小，可以非常容易的评估出所需时间和资源 6. 可衡量，我们可以对结果进行测试 -> 如果你是仓库的拥有者，你还可以编写一个`CONTRIBUTE.md`文件放在项目中，用来告知其他开发者需要如何参与你的项目。 +> 如果你是仓库的拥有者，你还可以编写一个 `CONTRIBUTE.md` 文件放在项目中，用来告知其他开发者需要如何参与你的项目。 #### Issue 的标题怎么写？[2] @@ -88,6 +88,22 @@ Issue 的翻译大致为**议题**、**问题**。 > Gitee 在提 Issue 时是支持 Markdown 格式的，它让我们提出的 Issue 能有更加丰富的内容展现。 +在 Gitee 中，支持在新建仓库时创建 Issue 模板，也支持自定义模板。 + +在新建仓库时，勾选`使用Issue模板文件初始化这个项目`，实际上就是在仓库根目录下新建了 `.gitee/ISSUE_TEMPLATE.zh-CN.md` 文件，当然你也可以自己创建这个文件，来编写自己的模板。 + +![选择使用模板来初始化项目](https://images.gitee.com/uploads/images/2020/1104/184559_3f5d281c_1277510.png "image-20201104183636294.png") + +自己创建 Issue 模板，可在仓库中创建`.gitee`目录，并创建对应的模板文件： + +1. `.gitee/ISSUE_TEMPLATE.zh-CN.md`，`Issue` 中文模板 +2. `.gitee/ISSUE_TEMPLATE.en.md`，`Issue` 英文模板 +3. `.gitee/ISSUE_TEMPLATE.zh-TW.md`，`Issue` 繁体模板 + +> Q: 不同类型的模板，有什么作用？ +> +> A: 例如你的仓库中有 3 种语言类型的 Issue 模板，提交 Issue 的用户使用的是英文版，那么当用户勾选`使用Issue模板`，则会智能地使用英文模板，如果对方使用的是中文版则会智能地使用中文 Issue 模板。 + 当你在敲标题或者 Issue 内容时，项目会自动显示已有的类似 Issue，你可以先查看一下推荐的 Issue 能否解决你的问题，如果不能再提出，避免反复提出同一个问题。 好了，当你完成 Issue 主体内容的填写之后，快去提交给作者吧！ @@ -234,7 +250,7 @@ Issue 在提出之后，对于个人版来说可以有四种状态：待办的 使用`#`符号再加上其他 Issue 的编号，可以关联到其它的 Issue。找到本仓库下 Issue 的编号之后写上即可。 -找到Issue编号（这里为`#I23WUE`）： +找到 Issue 编号（这里为 `#I23WUE`）： ![找到Issue编号](https://images.gitee.com/uploads/images/2020/1104/151115_93315a5e_1277510.png "image-20201104141131901.png") @@ -262,6 +278,7 @@ Gitee 支持的提交方式有（比如我们需要关闭的 Issue 编号为 24 + fixed #24 + close #24 + closes #24 ++ closing #24 + closed #24 + resolved #24 ``` -- Gitee