推 m6fisher:嗯?沒有JAVA是因為已經有JavaDoc嗎? 10/31 09:05
→ TonyQ:這是個好問題 兩年前就有人在討論了 XDDD 10/31 11:59
推 moonshade:原來style guide也有專案 XD 11/02 03:33
推 TCFmars:謝謝 11/05 01:35
昨天在噗浪上的討論有人提到可以參考 google 的 coding style，
我看了一下寫得還蠻詳細的，而且都有附理由，所以摘錄過來。
Style guide 也是一個 open source 專案 XD
https://code.google.com/p/google-styleguide/
-------------------------------
Google C++ Style Guide
http://google-styleguide.googlecode.com/svn/trunk/cppguide.xml
Google HTML/CSS Style Guide
http://google-styleguide.googlecode.com/svn/trunk/htmlcssguide.xml
Google JavaScript Style Guide
http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml
Google Python Style Guide
http://google-styleguide.googlecode.com/svn/trunk/pyguide.html
Google Objective-C Style Guide
http://google-styleguide.googlecode.com/svn/trunk/objcguide.xml
Shell Style Guide
http://google-styleguide.googlecode.com/svn/trunk/shell.xml
Google Common Lisp Style Guide
http://google-styleguide.googlecode.com/svn/trunk/lispguide.xml
※ 引述《moonshade (一隻歐拉貓)》之銘言：
: 2. 整齊格式的重要性，簡單來說就是一致的coding style，
: 新人似乎也不在乎這些東西為何重要，但是對老人來說，
: 這個影響一秒鐘看4行和一分鐘看2行的速度差別，但是對於無法
: 一秒四行的新人似乎無法理解這有多重要，甚至在hard tab的問
: 題也能爭吵不休，我已經解釋了每個人的tab width設定不一樣，
: coverity這類web-based viewer 也會看到不一樣，但是新人
: 還是堅持只要把tab width設成跟他一樣就好了。這個花了兩個老人
: 對他勸說了將近30分鐘，但也無法說動他把之前的code用sed
: 全改成空白鍵
: 3. 程式命名的藝術，很多人的程式寫得很好，根本不用comment
: 大家就能看懂，但是有新人就是不知為何發明一些需要解碼的
: 名稱，還宣稱這很好用很方便
: 4. Global 滿天飛，尤其在現在重視reentery的時代，global
: 就算無法避免也希望用singleton替代，但是講了半天又舉例，
: 最後還是不理你
: 其實說到最後新人並不是不願意學，而是對於沒有工作經驗的人
: ，這些東西就等於沒有道理，講了也不會記得，話說我剛入行
: 就是前輩說甚麼就照做，把code寫得跟老人一樣，讓他們以為是自
: 己寫的，但是現在的新人自己想法很多，也不知道怎麼教...
--
網頁上拉近距離的幫手 實現 GMail豐富應用的功臣
數也數不清的友善使用者體驗 這就是ｊａｖａｓｃｒｉｐｔ
歡迎同好到 AJAX 板一同討論。
--
※ 發信站: 批踢踢實業坊(ptt.cc)
◆ From: 61.230.20.186