---
title: 2023 年 Linux 核心設計/實作課程作業 —— review
image: https://i.imgur.com/yht9f2e.png
tags: linux2023
description: 回顧 第 1 次作業，補完指定進度。為 code review 做好必要的準備工作，練習 Software peer review。
---

# L06: review
> 主講人: [jserv](http://wiki.csie.ncku.edu.tw/User/jserv) / 課程討論區: [2023 年系統軟體課程](https://www.facebook.com/groups/system.software2023/)
:mega: 返回「[Linux 核心設計/實作](http://wiki.csie.ncku.edu.tw/linux/schedule)」課程進度表

==[第一次作業檢討 (2023 年)](https://hackmd.io/@sysprog/linux2023-lab0-review)==`*`
==[解說錄影 (2021 年)](https://youtu.be/Gwb-PC1azR0)==

## :memo: 預期目標

* 強化[第 1 次作業](https://hackmd.io/@sysprog/linux2023-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/linux2023-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](https://hackmd.io/@klouielu/BJjL6cQ6)，你的總結意見要寫在共筆的最上方，僅次於 "contributed by"。要從以下方面探討:
- 程式碼的 coding style, git commit messages
- 程式碼和共筆是否達到指定作業要求
- 實驗設計的不足處、涵蓋程度是否全面，以及後續的改進空間
- 共筆行文是否流暢且具體，結構規劃是否清晰 $\to$ 善用 ChatGPT 來改進漢語表達
* 建議引入新的方法或工具，如 Valgrind 參數變更、縮減排序的時間成本
* 斟酌在選定的 GitHub repository 留下 code review 意見
2. 需要回應授課教師 (會在共筆中標註 **:notes: jserv**) 和其他同學在你羅列於 [Homework1 作業區](https://hackmd.io/@sysprog/linux2023-homework1) 的共筆中所做的評語意見、建議，和提問
> 你可趁這個機會，在其他學員的共筆提交相關疑惑。
3. 繼續完成 [第 1 次作業](https://hackmd.io/@sysprog/linux2023-homework1) 的開發工作
* 不需要建立新的共筆，在你原本的頁面更新即可
* 第一週的作業**值得花上一個月來做**，但若授課教師一開始把繳交時限寫為四周，因人性使然，繳交的狀況就會很慘，於是授課教師故意縮短時限並安排在課堂檢閱，給同學們持續精進自己的機會。這樣或許會得更好的結果
4. 截止日期： Mar 21, 2023