不顯著 的關聯

不顯著 的關聯

不顯著 的關聯

不顯著 的關聯

註解及被描述的程式碼之間的關聯應該是顯而易見的。如果要寫

註解，至少要讓讀的人有辦法看出註解與程式碼之間的關係，這

樣才能理解註解在說些什麼。

/*

• start with an array that is big enough to hold all pixels
• …
  */
  this.pngBytes = new byte[(this.width + 1) * this.height * 3) + 200];

註解的目的在說明無法表達本意的程式碼，如果連註解本身都需要

額外的解釋，那真是一件遺憾的事。