FAQ

多个代码仓存在编译依赖时如何同时发起构建

OS(操作系统)开发时，经常会遇到多个代码仓的修改具有编译依赖关系，需要同时构建、同时合入。为此码云平台将Issue作为具有编译依赖的多个代码仓提交PR的关联标识。具体操作如下：

在此次提交的任意一个代码仓上创建Issue。
将多个需要同时构建、同时合入的PR关联上述Issue，具体操作请参考码云帮助中心：https://gitee.com/help/articles/4142。
触发构建(详见触发构建的操作帮助)后，构建中心会识别关联了同一Issue的PR，同时下载构建，并在代码审核通过后，同时进行合并入代码库。

`Signed-off-by`相关操作

如何在Commit中添加signoff记录

使用git commit -s 或 git commit –signoff 命令提交。

如何追加signoff到上一次commit?

执行git commit --amend --signoff命令。

关于commit更多选项，请参考：https://git-scm.com/docs/git-commit

DCO校验异常处理

开发者提交Pull Request后，评论start build会触发门禁校验：

该PR提交是否签署Developer Certificate of Origin（DCO) “开发者原创声明”。
该PR提交是否包含 Signed-off-by信息。

校验失败可能的原因有：

未签署“DCO协议”，例如提示：
```
当前检测到如下commit的用户未签署DCO协议：

•345612

•213123
```
解决办法：

点击这里签署、查看签署状态。

在PR的评论框输入check dco后，单击”评论”，系统将再次进行DCO校验。
Commits 中未包含 Signed-off-by信息，例如提示：
```
当前检测到如下commit未包含Signed-off-by信息：

•123123

•345612
```
解决办法：

参考Signed-off-by相关操作，添加Signed-off-by信息。格式为：Signed-off-by: user.name <user.email>。

在PR的评论框输入check dco后，单击”评论”，系统将再次进行DCO校验。
网页端/WebIDE提交PR的邮箱地址与签署DCO协议使用的邮箱地址不一致。

解决办法：

在Gitee的“设置 > 邮箱管理”中，查询提交邮箱设置是否准确。确保提交邮箱与签署DCO使用的邮箱地址一致。

说明：

如果在邮箱管理页面中，勾选了“不公开我的邮箱地址”，默认会生成一个xxxx@user.noreply.gitee.com的邮箱作为PR提交邮箱。如果需要使用其他邮箱作为提交邮箱，需要取消勾选“不公开我的邮箱地址”。

回退提交

请参考码云帮助中心：https://gitee.com/help/articles/4195

处理冲突

请参考码云帮助中心：https://gitee.com/help/articles/4194

门禁检测问题处理

门禁检查项	常见报错信息
API参考链接跳转锚点准确	1. 链接名称在标题及标题下表格均不存在 2. 链接名称不准确 3. 检测到链接名称与目标页面标题不一致
有序列表格式	序列号格式异常
代码块格式	代码块格式错误
代码块缩进格式	代码块缩进异常
代码块未指定语言提示	代码块未指定语言
表格格式	1. 存在制表符 2. 表格至少需要三行（标题行、分隔符行和数据行） 3. 标题行格式不正确，存在空列 4. 标题行格式不正确 5. 缺少标题行 6. 缺少分隔符行、或分隔符行格式不正确 7. 标题行和分隔符行的列数不一致 8. 数据行格式不正确，存在空列 9. 数据行格式不正确 10. 数据行的列数与标题行不一致
“说明”，“注意”格式规范	1. 表格中错误：第xxx行表格总说明或注意格式不符合写作规范 2. 正文中错误：第xxx行提示语错误；错误信息：
HTML标签规范	1. 第xxx行br错误 2. 第xxx行sup错误
@link异常检测	第xxx行链接错误；错误信息
链接（图片链接）格式错误	链接格式错误
标题存在序号	标题中有序号
示例代码中不可使用console.log	日志打印方式错误；不可使用console.log进行日志打印。
代码注释符	代码注释格式异常
JSON/JSON5代码格式检查	json代码块中格式存在异常，请将代码块放置在IDE中进行确认处理。
段落格式	段落之间需要存在空行
urlpath检查	urlpath格式检查

FAQ