# 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/#/)，注冊成功后把用戶名告知管理員