# README_FIRST --- [TOC] ## 协同办公 - [钉钉](https://www.dingtalk.com/) ## 文档 - 产品文档（需求、PRD、商业宣导等）格式不限，可以使用office系列或markdown书写转pdf等 - 技术文档，包括但不限于API描述、接口文档、逻辑描述等，一律使用markdown格式书写，关于markdown的简要教程[请看这里](https://www.jianshu.com/p/q81RER)， 阅读时间大约10分钟即可上手 - 了解markdown基础后，即可在编辑器中立马实践，关于编辑器的选择[请看这里](https://www.williamlong.info/archives/4319.html) - 团队文档集中在[看云](kancloud.cn)，请注册后将注册的邮箱告知管理员，管理员会添加各位成员 ## 版本管理 - 关于git的基础操作[请看这里](http://www.ruanyifeng.com/blog/2015/08/git-use-process.html) - 关于git的GUI客户端，请统一使用[sourcetree](https://www.sourcetreeapp.com/)，对sourcetree不太熟悉的同学请看这篇足矣，[传送门](https://www.cnblogs.com/tian-xie/p/6264104.html) - 关于git的工作流，我们统一使用gitlab flow，相关介绍请点[传送门](http://www.ruanyifeng.com/blog/2015/12/git-workflow.html)，一言概之就是远程分支一共有master/pre-production/production。开发分支是master，开发人员本地的功能分支请以`feature\-` 开头或者以 `bugfix\-` 开头；本地分支功能实现后，merge到开发分支master上，并push到remote/origin/master上做联调测试；确认无误后，管理员合并到pre-production分支，准备预发布环境；确认无误后，即可发布，即合并到production分支。 ## 代码托管 - [注册传送门](https://dev.tencent.com/login)，注册完成后请把注册邮箱和用户名告知管理员 ## ssh公钥密钥 - 在windows环境中请先安装[gitbash](https://gitforwindows.org/)，git bash可以认为是和sourcetree一样的git客户端工具，区别在于一个是命令行一个是GUI。安装完之后，请在git bash中生成ssh公密钥对，操作流程请看[传送门](https://blog.csdn.net/jom_ch/article/details/9285683)，然后把生成的公钥文件告知管理员。git管理走ssh协议，所以必须要有ssh公钥作为你的个人身份识别 ## 前端开发工具 - **IDE** VSCode or More ? - Mock工具，推荐[easymock](https://easy-mock.com/docs)，注册成功后把用户名告知管理员 ## UI工具 - 蓝湖，[传送门](https://cn.technode.com/post/2017-06-07/lanhu/)，[注册看这里](https://lanhuapp.com/web/#/user/register)，[新手教程](http://sos.lanhuapp.com/#/)，注册成功后把用户名告知管理员