實事求是-以科學的態度做事情

先看看這個針對Design內部的一個控制功能所做的敘述:

Enable Schmitt trigger at input comparator, in case there is a voltage dip below VREF.
0: disable Schmitt trigger at input comparator.
1: enable Schmitt trigger at input comparator.

對我來說,
1) 首先, 針對控制功能的解釋, 這樣是牛頭不對馬嘴. 這樣的講法是使用說明, 並不是功能解釋.
2) 就算是使用說明好了, 這個敘述還是不完整, 你看, 後面那句: “in case there…” 應該是針對前面那句所說的, 但是兩者的連結需要使用者對 “Schmitt trigger” 有很了解. 如果要擴大使用群, 一定要更加強說明.
3) 這整個說法, 其實只是個定性的敘述, 0 跟 1 對使用者來說, 就好像說面對的是男人或女人而已, 但如果我們要更了解, 譬如說, 我面對的這個男人(或女人)是怎樣的年紀, 有怎樣的頭髮, 多高..等等, 有了這些資訊, 我們在面對的時候比較容易知道清楚要用什麼樣的態度.

以下就是改過的:

Schmitt Triggered Input
This bit is to enable Schmitt triggered capability for the input comparator for all the interface signals. With this bit enabled, all the signals on the bus can be protected from signal wrongly transmitted in case there is a voltage drop below VREF.
0: Disabled, the rising/falling threshold voltage for all the interface signals stayed at 0.10v/1.0v.
1: Enabled, the rising/falling threshold voltage for all the interface signals would be 0.20v/0.9v.

很關鍵的一點是, 如果我們能以定量的方式來描述, 不但能夠更精確的闡述事實, 讓人家更理解. 事實上, 在實務的操作上, 更是一個 double check 的過程. 這裡舉的這個功能動作, 在深入追蹤之後, 發現已經不存在了. 但如果不是鍥而不捨的追, 就不會發現design 上真的不存在了.