--- title: Facebooc 使用說明 date: Apr 11, 2022 --- # 協作規範 :::success 使用 GitHub Pull Request 提交 使用 Trello 作為任務進度、責任追蹤 使用 公用聯絡方式 聯絡 ::: :::info **如有問題** 1. 請於 Trello 回報 2. 如有技術問題,歡迎詢問楊志璿( @25077667 ) ::: 如有要求提供「分工表」,將另開文件自行填寫。(人在做,Google在看,請誠實面對自己) ## 協作方式 ## 原始碼分支 1. 請 [Fork](https://gitbook.tw/chapters/github/syncing-a-fork) 到你自己的倉庫,進行修改後,再 Pull Request (Contribute) 到[主要倉庫](https://github.com/25077667/facebooc),[如何發 PR](https://gitbook.tw/chapters/github/pull-request) 2. 審核通過條件:至少 GitHub Action 評判結果要是**勾勾**,才會被都入到主要倉庫的 master 分支 3. Commit message (提交訊息)要求, [ref](https://blog.louie.lu/2017/03/21/%E5%A6%82%E4%BD%95%E5%AF%AB%E4%B8%80%E5%80%8B-git-commit-message/) 1. 用一行空白行分隔標題與內容 2. 限制標題最多只有 50 字元 3. 標題開頭要大寫 4. 標題不以句點結尾 5. 以[祈使句](https://blog.english4u.net/blog2.aspx?id=39)撰寫標題 6. 內文每行最多 72 字 7. 用內文解釋 what 以及 why vs. how 8. 可中文,但同上規則 5. 作業環境 部屬於 Linux,如果你要測試你的程式碼,確認使用 Linux 環境。 最低 Linux 版本 5.3 ### 開啟 GitHub Actions: [Fork 之後務必開啟 GitHub Actions](https://hackmd.io/@sysprog/linux2022-lab0#GitHub-Actions-%E8%A8%AD%E5%AE%9A) ## Trello 看板 請大家至少訂閱 `Bulletin Board` 看板和 `Can` 清單,若有認領工作(卡片)也請訂閱該工作(按`join this card`按鈕會自動訂閱)。 ### Bulletin Board 板 如同字面意義,可以放要被大家反覆瀏覽的資訊 ### Work flow 板 #### Can 此清單為預設罐頭。通常有新的提案都會先放過來這裡,若認領工作,請點擊該卡片右側`自動化`項目中的 `join this card` 按鈕,裡面有一系列自動化功能。 #### Working - 當該項目有認領時,卡片會被 `join this card` 按鈕移動到這裡。 - 若項目以被完成,請點選 `finish!` 按鈕,將該卡片移動到 `Finished` 清單中。 #### Finished 完成後的項目就會放到這裡,這裡每週會自動清空卡片。 # 提問方式 - [花5分鐘閱讀受用一生的提問方式](https://israynotarray.com/learnexp/20200112/1752686187/) 1. 上網搜尋至少 10 分鐘 2. 寫清楚你的問題,沒有人會通靈 3. 最好能夠附上問題截圖或者錯誤訊息 ==當你卡關,盡快提問== # 其他瑣碎事物 ## 歷史與拋棄歷史 繼承於 Jserv 的 Facebooc 專案,但是因為他的程式有諸多缺陷,在一定協調下,我們必須拋棄歷史包袱。 - 使用 Linux 環境部屬,因此原先跨平台的 Macro 可以取消,並且最佳化。