作者herospeed (タシロス・シェン)
看板NIHONGO
標題[格言] プログラマうーの格言
時間Tue Nov 11 13:11:24 2008
詳細設計はソース内のコメントにて完結する.
コメントだけが唯一の自衛手段であるから,
少なくとも本人が理解できるように書かれている.
※註解
對程式設計師來說,
真正的詳細設計並不是從系統工程師手裡拿到的那份,
而是紀錄在程式碼裡面的註解。
因為從系統工程師裡面拿到的那份,
並非是以程式設計師的觀點來看,
而是以系統工程師的觀點所做的。
而程式碼基本上,就有如作文一般,
一樣的設計,也會出現很多種不同的寫法,
因為程式碼裡面,會參雜著程式設計師的個性,以及習慣。
所以一般來說,去讀解別人所寫的程式碼是一件很困難的事情。
就連自己寫過的程式碼,過半年之後再來看,
自己都不一定能看的懂了,更何況是別的程式設計師寫的程式碼呢?
所以為了防止這樣的問題發生,程式設計師們會把詳細設計寫成註解。
因為至少讀解自己寫過的註解,比讀解自己寫過的程式碼,
還要來的簡單多了。
--
████ ◥◤ ◢ ████ ████ ◥◤ ◢ ◣
█ █ █ █ █ ◢◤ █ ███ ◥◤ █
◤◥◣█ ◥◤ █ █ █ ◢◤◣ ● ◥◤ █ █ █
◢◤ ◢██◤ ████ ◢◤ █ ◢██◤ ███ ◢██◤
--
※ 發信站: 批踢踢實業坊(ptt.cc)
◆ From: 125.197.234.21
推 johanna:詳細設計僅存於程式碼內的附註。附註是唯一的自衛手段, 11/11 17:15
→ johanna:至少那是為了讓我看懂而寫的。 11/11 17:15