贡献指南¶
我们欢迎对 esp-faq 项目做出贡献，如修复错误，添加文档等。我们通过 Github Pull Requests 接受贡献。
提交流程¶
这一节，是对 新增问题 和 修改问题 两个操作的流程简要介绍，流程中涉及的环节具体要求，请点击链接查看。
针对 git 相关操作不做具体的介绍，可以查看 Git 相关教程。
新增问题¶
修改问题¶
新建分支¶
新建分支都基于 主分支 进行；操作时，请留意当前所在分支是否为你期望合入的分支。
操作示例:
git status #查看当前分支
git checkout -b add/artificial-intelligence_camera_model #用于新增问题 "artificial-intelligence camera model"
分支命名规范¶
新增问题：
add/artificial-intelligence_{q&a}，{q&a}使用文件名的英语简要，例如新增artificial intelligence camera model问题，分支名：add/artificial-intelligence_camera_model。修改问题：
mod/artificial-intelligence_q&a，q&a使用文件名的英语简要，例如修改artificial intelligence camera model问题，分支名：mod/artificial-intelligence_camera_model。
问题编辑规范¶
请按照以下格式规范规则添加或更新 Q&A：
通用规则：
添加新的 Q&A 时，切记需在前项问题后添加分隔符“—————-”。
问题格式：
须简洁清晰地描述问题，如：
ESP32-S2 固件烧录时出现错误 “A fatal error occurred: Invalid head of packet (0x50)”？（问题不清晰）
ESP32-S2 固件烧录时出现错误 “A fatal error occurred: Invalid head of packet (0x50)”。如何解决？（清晰）
问题不宜过长。如描述太多，可精炼出主要的问题作为标题，并在回答的正文中详细描述问题背景及细节。
答案格式：
如正文中需引用代码，请使用 code 语法将其与文字隔开。
如某个问题的回答仅包含一句话，则使用正常段落书写即可，无需使用列表。
需要列举多个条目或排列顺序时，请使用列表：
数字列表：有一定顺序（如操作步骤），或后文中需引用列表中的某个条目。
项目符号列表：无特定顺序。
列表前需有介绍性文字，说明下述列表的含义或目的，且以冒号“：”结尾。
如两项条目是互为选择的关系，应使用项目符号列表罗列（非数字列表），并在段前介绍性文字中说明这二者的关系。
正文中（不论列表还是段落），每一行之前需空两格。
如某项条目后需跟注释或说明性文字，应缩进该注释，使其成为子条目。
关于列表中标点符号的使用，请参考 Espressif Manual of Style 中的章节 “Punctuation in Lists”。
更多关于列表格式的规则指导，请参考 Bulleted and Numbered Lists。请参阅下文文字与图片示例模版。
问题模块示例¶
-------------- 乐鑫是否已有 AI 图像识别的产品？ ------------------------------------- 乐鑫已有标准开发板 ESP-EYE，主控芯⽚为 ESP32，可兼容 0v2640，3660，5640 等多款摄像头。
问题图片示例¶
-------------- curses.h: No such file or directory？ ------------------------------------------- 问题截图：support ESP8266 chip, but ESP8266_RT .. figure:: _static/application-solution/android-application/case_two_kconfig_error.png :align: center :width: 900 :height: 100 解决方法 ：sudo apt-get install libncurses5-dev
本地编译环境¶
测试验证环境使用 ubuntu 或 Debian 系统，配置 python 环境为
3.7。推荐使用 python 虚拟环境，或者 docker 环境。
# 安装 python3.7 与虚拟环境
sudo apt-get install python3.7 python3.7-venv
# 创建虚拟环境
python3.7 -m venv ~/.pyenv3_7
# 激活虚拟环境
source ~/.pyenv3_7/bin/activate
# 更新 pip
pip install --upgrade pip
# 安装 pip 组件
pip install -r docs/requirements.txt
# 编译中文版本
cd docs/cn/ && make html && cd -
# 编译英文版本
cd docs/en/ && make html && cd -
# 退出虚拟环境
deactivate
提交信息规范¶
在分支上添加提交信息，以说明添加/修改/删除问题功能。每个提交都有一条消息，例如：
artificial-intelligence: add esp-eye support those camera models
1. esp-eye support those camera models.
提交信息的第一行应类似于“问题类别：添加/修复/删除/更改内容”。第一行以提交要更改的文件名的名称开头。例如：
artificial-intelligence: esp-eye support those camera models.
要添加有关该提交的更多详细信息，请将其放在第一行之后的提交消息中。
一个好的 git 提交消息讲述了一个为什么发生更改的故事，因此，阅读提交日志的人可以了解项目的开发。编写良好的提交信息现在看来似乎是在浪费时间，但是在将来尝试了解某些原因更改时，这对您和您的同事很有用（对我们的客户也有用）。
提交合并请求¶
一旦完成修改就可以对分支进行第一次提交，如果您需要进行更多的更改，请进行更多提交。完成您对该分支的所有提交后，提交合并请求。
我们使用 github 合并请求功能将分支合并到主分支中，步骤：
将您的分支推送到 github 仓库；
转到 esp-faq，然后单击 “New pull request”；
选择您刚创建准备合并的分支，然后填写“合并请求”详细信息。
参考：IDF贡献代码。
提交合并请求相关规范¶
Title 要求:
add: 简要描述
Description 要求:
分点描述该合并修改的信息。
示例：
Title:
artificial-intelligence: add esp-eye support those camera models.
Description:
1. add esp-eye support those camera models.