2022-07-10 19:23:01 +08:00
|
|
|
|
---
|
|
|
|
|
|
title: 交流反馈（Issue）
|
2024-08-07 16:29:07 +08:00
|
|
|
|
description: 本文规定了在Git协作中创建Issue的格式，包括新需求、缺陷反馈和答疑交流的模板，要求提供背景、思路、实现和报错信息。
|
2023-06-26 17:37:53 +08:00
|
|
|
|
keywords:
|
2024-08-07 16:29:07 +08:00
|
|
|
|
- Git Issue
|
2023-11-09 17:30:33 +08:00
|
|
|
|
- 交流反馈
|
2024-08-07 16:29:07 +08:00
|
|
|
|
- 需求
|
|
|
|
|
|
- 缺陷
|
|
|
|
|
|
- 答疑
|
2023-06-26 17:37:53 +08:00
|
|
|
|
tags:
|
2023-11-09 17:30:33 +08:00
|
|
|
|
- 软件工程/Git协作
|
2024-04-26 21:42:22 +08:00
|
|
|
|
- 技术/软件工程
|
2023-06-26 17:37:53 +08:00
|
|
|
|
author: 7Wate
|
|
|
|
|
|
date: 2023-06-26
|
2022-07-10 19:23:01 +08:00
|
|
|
|
---
|
|
|
|
|
|
|
2023-06-26 17:37:53 +08:00
|
|
|
|
文件命名：**ISSUE.md**。
|
2022-07-11 14:36:46 +08:00
|
|
|
|
|
2023-06-26 17:37:53 +08:00
|
|
|
|
## 新需求（Pull Request）
|
2022-07-11 14:36:46 +08:00
|
|
|
|
|
2023-11-09 17:30:33 +08:00
|
|
|
|
规范：使用 `Pr<scope>:title` 来命名。`<scope>` 表示需求涉及的模块或功能，`title` 则表示具体需求的主题。
|
2023-06-26 17:37:53 +08:00
|
|
|
|
|
|
|
|
|
|
示例：`Pr(auth):role-based authorization`
|
|
|
|
|
|
|
|
|
|
|
|
提交新需求时，请遵循以下格式：
|
2022-07-10 19:23:01 +08:00
|
|
|
|
|
|
|
|
|
|
规范：`Pr<scope>:title`
|
|
|
|
|
|
|
|
|
|
|
|
示例：`Pr(auth):role-based authorization`
|
|
|
|
|
|
|
|
|
|
|
|
```markdown
|
|
|
|
|
|
## 背景
|
|
|
|
|
|
|
|
|
|
|
|
- 描述你希望解决的问题
|
2023-06-26 17:37:53 +08:00
|
|
|
|
- 如果相关的 issue 或社区帖子已存在，请附上链接
|
2022-07-10 19:23:01 +08:00
|
|
|
|
|
|
|
|
|
|
## 思路
|
|
|
|
|
|
|
2023-06-26 17:37:53 +08:00
|
|
|
|
描述解决思路，可以包含 API 设计和伪代码等。
|
2022-07-10 19:23:01 +08:00
|
|
|
|
|
|
|
|
|
|
## 实现
|
|
|
|
|
|
|
2023-06-26 17:37:53 +08:00
|
|
|
|
附上对应的 Pull Request 地址。如果还未实现，可以描述你打算如何实现此需求。
|
|
|
|
|
|
|
2022-07-10 19:23:01 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
2023-06-26 17:37:53 +08:00
|
|
|
|
## 反馈缺陷（Bug）
|
2022-07-10 19:23:01 +08:00
|
|
|
|
|
2023-11-09 17:30:33 +08:00
|
|
|
|
在提交 Bug 前，请务必先阅读**提问的智慧！**
|
2022-07-10 19:23:01 +08:00
|
|
|
|
|
2023-11-09 17:30:33 +08:00
|
|
|
|
规范：使用 `Bug<scope>:title` 来命名。`<scope>` 表示 Bug 涉及的模块或功能，`title` 则表示 Bug 的主要问题。
|
2022-07-10 19:23:01 +08:00
|
|
|
|
|
|
|
|
|
|
示例：`Bug(login):Admin password cannot be reset`
|
|
|
|
|
|
|
2023-11-09 17:30:33 +08:00
|
|
|
|
提交 Bug 反馈时，请遵循以下格式：
|
2023-06-26 17:37:53 +08:00
|
|
|
|
|
2022-07-10 19:23:01 +08:00
|
|
|
|
```markdown
|
|
|
|
|
|
## 运行环境
|
|
|
|
|
|
|
|
|
|
|
|
- 系统（Linux、Mac、Windows）
|
|
|
|
|
|
- 环境（运行版本、配套软件版本）
|
|
|
|
|
|
|
|
|
|
|
|
## 该问题是怎么引起的？
|
|
|
|
|
|
|
|
|
|
|
|
- 简述可能引起的原因和操作步骤
|
|
|
|
|
|
|
|
|
|
|
|
## 重现步骤
|
|
|
|
|
|
|
|
|
|
|
|
- 陈述可以复现 Bug 的详细步骤
|
|
|
|
|
|
|
|
|
|
|
|
## 报错信息
|
|
|
|
|
|
|
2023-06-26 17:37:53 +08:00
|
|
|
|
- 附上具体的报错信息、日志等。如果可能，截图也会非常有用。
|
|
|
|
|
|
|
2022-07-10 19:23:01 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
2023-06-26 17:37:53 +08:00
|
|
|
|
## 答疑交流（Usage）
|
2022-07-10 19:23:01 +08:00
|
|
|
|
|
2023-06-26 17:37:53 +08:00
|
|
|
|
一般来说，我们更推荐使用社区自助交流方式。
|
2022-07-10 19:23:01 +08:00
|
|
|
|
|
2023-11-09 17:30:33 +08:00
|
|
|
|
规范：使用 `Usage<scope>:title` 来命名。`<scope>` 表示问题涉及的模块或功能，`title` 则表示问题的主要内容。
|
2022-07-10 19:23:01 +08:00
|
|
|
|
|
|
|
|
|
|
示例：`Usage(update):1.2.3 version update failed`
|
|
|
|
|
|
|
2023-06-26 17:37:53 +08:00
|
|
|
|
提交问题或请求帮助时，请遵循以下格式：
|
|
|
|
|
|
|
2022-07-10 19:23:01 +08:00
|
|
|
|
```markdown
|
|
|
|
|
|
## 运行环境
|
|
|
|
|
|
|
|
|
|
|
|
- 系统（Linux、Mac、Windows）
|
|
|
|
|
|
- 环境（运行版本、配套软件版本）
|
|
|
|
|
|
|
|
|
|
|
|
## 报错信息
|
|
|
|
|
|
|
2023-06-26 17:37:53 +08:00
|
|
|
|
- 提供详细的报错信息、日志等。截图，如果可能，也是非常有用的。
|
|
|
|
|
|
|
2022-07-10 19:23:01 +08:00
|
|
|
|
```
|
