在本页中，你将会了解到如何通过github与他人合作完成代码。但是，由于编写者精力有限由于自学对于程序编写者是一个必不可缺的过程（编者所写内容也均为自学而来），本页面不会对可能遇到的问题、具体的流程、（可能的）相关的繁琐步骤作出详细说明。
GitHub是一个程序员的社交软件。
——《GitHub漫游手册》
(在GitHub中搜索GitHub漫游手册以查看完整内容)
通过GitHub，你可以：
等等。
对于FTC比赛，使用GitHub作为远程托管服务平台是非常有优势的。
首先，我们的母仓库（指的是比赛所需代码环境）在GitHub上；
GitHub上有很多其他队伍的优秀案例；
GitHub广告少，界面清爽，下载便捷（点名批评Gitee）；
GitHub上有许多我们所需要的插件（比如RoadRunner）
……等等。
纵使它也有缺陷——比如网速慢，但瑕不掩瑜，在最后，我们选择了GitHub。
GitHub官网是：GitHub.com。
访问其官网并点击右上角注册。
搜索栏中可以搜索（非常明显，对吧？），点自己头像可以修改信息，邮件按钮可以收到站内消息（比如组织邀请、Pull Request等等）。
打开一个存储库，页面右侧有release（屏幕太窄的话会在最下方），有些时候作者会提供预编译软件包给你。
遇到使用上的问题，可以给作者提交issue，询问作者，帮助提升软件。
GitHub Copilot是（非常好用的）AI工具，可以访问gpt4等等工具。具有免费额度。（正常使用都是够的）
建议配套github desktop使用。其图形化的界面简洁直观，且在对github的网络链接上表现稳定。
下载链接：https://desktop.github.com/download/
看到喜欢的存储库，不妨点个Star，就像点赞一样。
想要修改一个没有权限的存储库，可以点击Fork——或者说，复刻——在你的账户或你所属的组织账户下复制一份可以收到原项目更新的存储库；随后修改，commit（本地），push（上传），pull request（提交审核）。
如果你具有权限——你和你的同伴在同时修改一个存储库。为了不互相影响——不妨创建分支（branch）。你在你的分支修改，我在我的分支修改。写完一个功能，merge进main分支。
简单来说，就是这样。
1：每次push前请先本地commit并pull（先stash，在pull之后恢复也可），检查有无兼容性问题，不要提交会导致编译/运行错误的代码。
2：每次commit需在提交标题中注明提交日期，修改内容，（提交人）
正常的Commit信息应当书写的是你更新/修复了什么功能，比如说
Fix The Calculation Problem In SixServoArmCalculator.java，Remove The Debug Telemetry in SixServoArmOutputter.java诸如此类（可以甚至建议用中文，没有必要使用英语）。 避免修改内容中只提到文件名——一时偷懒的后果就是其他人和自己一段时间后不打开具体内容根本不知道改了什么对于上传者信息：如果是用自己的账号进行提交可以省略，但如果使用社团账号或在别人账号下提交，应当备注实际提交人信息（e.g.拼音首字母简写）
3：一般情况下所有人均在master内工作即可， 但如果对某些分功能（e.g. 视觉、机械臂）进行长期脱离主干的工作时也可以新建分支。
4：合适的commit时机
每次Commit只做一件事情，即你如果修改了多个文件，且关联不大，请分开commit——每次仅勾选部分内容，分别标注修改内容。同样的，请不要将commit当作保存键。一件未完成的工作上传，会影响其他人的工作——编译器数十个的报错，调用时混乱的逻辑。即使只本地commit，也会造成后续查找的不便。所以，请完成一个功能/修改一个错误后再提交