--- title: 2022 年 Linux 核心設計/實作課程作業 —— review image: https://i.imgur.com/yht9f2e.png description: 回顧 第 1 次作業,補完指定進度。為 code review 做好必要的準備工作,練習 Software peer review。 --- # K06: review ###### tags: `linux2022` > 主講人: [jserv](http://wiki.csie.ncku.edu.tw/User/jserv) / 課程討論區: [2022 年系統軟體課程](https://www.facebook.com/groups/system.software2022/) :mega: 返回「[Linux 核心設計/實作](http://wiki.csie.ncku.edu.tw/linux/schedule)」課程進度表 ==[解說錄影](https://youtu.be/Gwb-PC1azR0)== ## :memo: 預期目標 * 強化[第 1 次作業](https://hackmd.io/@sysprog/linux2021-homework1),補完指定進度 * 為 [code review](https://en.wikipedia.org/wiki/Code_review) 做好必要的準備工作,練習 [Software peer review](https://en.wikipedia.org/wiki/Software_peer_review) * 歌德說:「要欣賞自己的價值,就得給世界增添價值」,從反省和觀摩中重新檢視自己作品的具體突破機會 * [軟體工程師要學會說故事](https://ruddyblog.wordpress.com/2016/06/18/),從良性詳盡的批評開始 ## :rocket: Code Review * 錄影: [Amazing Code Reviews: Creating a Superhero Collective](https://youtu.be/ly86Wq_E18o) * Google 公司提供的 [Technical Writing Courses](https://developers.google.com/tech-writing) > ==Every engineer is also a writer.== ## :penguin: 作業要求 1. 研讀上方 :rocket: **Code Review** 區域所列出的錄影及投影片,在 ==[Homework1 作業區](https://hackmd.io/@sysprog/linux2022-homework1)== 挑出自己以外的 5 項學生開發成果並給予眉批 $\to$ 在開發紀錄後方標注 "::: Reviewed by 你的GitHub帳號名稱",像是 > 開發紀錄 (lab0) / GitHub ::: Reviewed by `jserv` :::warning 中間的空白不要漏掉了,在 `)`, `/`, `:::` 之間都有。並且你的 GitHub 帳號名稱前後要標註 =="`"== ::: * 每份開發成果至多只能被 4 個人批評,"Reviewed by" 後面的 GitHub 帳號用半形逗號 `,` 分隔 * 可參照 [2019 年春季 Homework2 作業區](https://hackmd.io/@sysprog/rygjaEK8V) * 選定開發紀錄後,編輯內文,加上 `Reviewed by 你的GitHub帳號名稱` 的段落,[示範的 Review](/s/BJjL6cQ6),你的意見要寫在共筆的最上方,僅次於 "contributed by"。要從以下方面探討: - 程式碼的 coding style, git commit messages - 程式碼和共筆是否達到指定作業要求,例如 [lab0](https://hackmd.io/@sysprog/linux2022-lab0) 要求實作的 coroutine - 實驗設計的不足處、涵蓋程度是否全面,以及後續的改進空間 - 共筆行文是否流暢且具體,結構規劃是否清晰; * 建議引入新的方法或工具,如 Valgrind 參數變更、縮減排序的時間成本 * 斟酌在選定的 GitHub repository 留下 code review 意見 2. 需要回應授課教師 (會在共筆中標註 :notes: jserv) 和其他同學在你羅列於 [Homework1 作業區](https://hackmd.io/@sysprog/linux2022-homework1) 的共筆中所做的評語意見和質疑 3. 繼續完成 [第 1 次作業](https://hackmd.io/@sysprog/linux2022-homework1) 的開發工作 * 不需要建立新的共筆,在你原本的頁面更新即可 * 第一週的作業值得花上一個月來做,但若授課教師一開始把繳交時限寫為四周,因人性使然,繳交的狀況就會很慘,於是授課教師故意縮短時限並安排在課堂檢閱,給同學們持續精進自己的機會。這樣或許會得更好的結果 4. 截止日期: Mar 28, 2022 (含) 之前