Re: [請益] 如何沉住氣讀別人的 code

看板Soft_Job作者 (HANA)時間6年前 (2018/01/28 21:02), 6年前編輯推噓6(6012)
留言18則, 12人參與, 6年前最新討論串7/7 (看更多)
: : 堂堂地表最強軟體公司也是不會統一的....... : : 至於"coding sytle" 他們通常會用clang-format去整理 所以還算一致 : 程式碼風格在大型專案裡頭著實是一件很難搞的事情,在很難去分高下的前提下真的要 : 論往往會變成宗教戰爭,參與開源專案這幾年看過不少年薪幾百萬台幣的工程師吵風格 : 得不可開交然後又不了了之。 : 回到主題。閱讀他人的程式碼是一件極度需要修養的工作,除了耐心以外,老實說我也 : 確定到底有啥訣竅,不過我個人蠻喜歡一個小技巧,就是幫別人的程式碼寫註解。尤其 : 此次的修改需要用到別人的程式碼而且又很難啃的時候,幫忙寫點註解除了確保自己真 : 有看懂以外,也可以做功德的幫助下一個可憐的工程師。 來打打屁 自認對coding style沒有很嚴格的要求 最基本的讓人看出這一包在作啥就算了 最近跟國外的同事合作 我突然發覺我對README有沒有好好寫這件事很鑽牛角尖 委託了對方開發一個功能 最後對方交差的source code結構如下 project - pom.xml - src - job.java 這個在衝碼改阿 先不管內容如何 怎麼測試怎麼執行一句未提就這樣一包放到github 就這樣我第一次看也不想看的Reject別人的交付 請對方改之後對方也淡淡的回一句 "sure..." 我以為把README寫好是很基本的,是我很奇怪嗎 趁機問一下平常各位大牛都有寫README的習慣嗎 -- ※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 153.218.109.252 ※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1517144535.A.CFB.html ※ 編輯: del680202 (153.218.109.252), 01/28/2018 21:03:22

01/28 21:08, 6年前 , 1F
如果要交付原始碼,又沒辦法當面講的話寫個說明很應該的
01/28 21:08, 1F

01/28 21:08, 6年前 , 2F
一堆人不喜歡寫文件的,都認為自己的程式碼寫的漂亮
01/28 21:08, 2F

01/28 21:08, 6年前 , 3F
就好
01/28 21:08, 3F

01/28 22:36, 6年前 , 4F
mvn test 啊
01/28 22:36, 4F

01/28 23:04, 6年前 , 5F
Read me 沒有很重要啊
01/28 23:04, 5F

01/29 00:17, 6年前 , 6F
有些熱門包的README都寫短短的 都寫在WIKI
01/29 00:17, 6F
那類包因為說明長 readme變成了目錄般的角色 總的來說該寫的東西都還是有好好寫的

01/29 00:28, 6年前 , 7F
readme說明 test指令跟 dev指令算頗基本的事情
01/29 00:28, 7F

01/29 02:29, 6年前 , 8F
細膩的 連部署常見問題都有
01/29 02:29, 8F
※ 編輯: del680202 (126.199.129.212), 01/29/2018 06:50:18

01/29 08:47, 6年前 , 9F
java挺麻煩的 一堆步驟
01/29 08:47, 9F

01/29 11:16, 6年前 , 10F
java請愛用@annotation功能
01/29 11:16, 10F

01/29 11:22, 6年前 , 11F
看到pom.xml就知道是用maven,我覺得其實還好耶...
01/29 11:22, 11F

01/29 11:23, 6年前 , 12F
理解別人的程式碼的架構也是要看經驗的 這類的部署套
01/29 11:23, 12F

01/29 11:23, 6年前 , 13F
件以及相關的框架 都算是Java的共通語言
01/29 11:23, 13F

01/29 11:24, 6年前 , 14F
最怕是沒有框架 單純native java寫整個service的程式
01/29 11:24, 14F

01/29 11:26, 6年前 , 15F
聽朋友分享 一堆公司不用框架或用自家框架來寫程式
01/29 11:26, 15F

01/29 11:26, 6年前 , 16F
遇到這種才真的會吐血
01/29 11:26, 16F

01/29 12:55, 6年前 , 17F
如果裡面真的只有這2個檔案那你還蠻鑽牛角尖的
01/29 12:55, 17F

02/01 20:19, 6年前 , 18F
推樓上。
02/01 20:19, 18F
文章代碼(AID): #1QRSdNpx (Soft_Job)
討論串 (同標題文章)
文章代碼(AID): #1QRSdNpx (Soft_Job)