看板 Tech_Job作者 truth0 (加油!)標題 [請益] 當主管要求員工留下獨門經驗的技術文件時間 Mon Feb 7 23:50:02 2022
請問當主管要求資深RD撰寫自己經驗的文件,
請問員工該如何運對呢?
我隨便舉個例子
已寫C++語言程式為例
有個10年資歷的A員工,
常自己加班練習程式語言,六日沒事也練習程式刷leetcode,
10年下來,
累積了不少對語法的深刻了解,
把自己負責的project寫得又快又好,
主管於年前三個月,要求該員工撰寫文件詳細講解自己的code,
內文不只要能讓別的員工能接手此程式,。
(PS,原本程式內就有基本的comment和說明)
主管還要求在文件中,要詳細敘述自己當初的思考邏輯,
為什麼要這樣的寫?為什選用這語法?
和別的寫法相較差別在哪?
詳述每個寫法的好處壞處及潛在影響?
請問該如何回應比較好呢
1.掏心掏肺全部寫出來
2.保護自己,也給主管面子,寫一些,但沒寫這麼詳細
3.不認真處理這需求
小弟職場菜鳥,請各位老鳥指點
謝謝
--
--
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 36.229.233.104 (臺灣)
※ 文章代碼(AID): #1Y0J-iQI (Tech_Job)
※ 文章網址: https://www.ptt.cc/bbs/Tech_Job/M.1644249004.A.692.html
推 v7q4: 寫寫基本的、查得到的東西就好1F 02/07 23:51
推 iamala: 我自己是都寫出來啦...創造和抄襲有本質上的不同，坦白說人類就是你掏心掏肺給別人看，對方還是視而不見的生物。所以不用藏。3F 02/07 23:53
→ erial: 真的又快又好，應該去面試解白板題，這樣就知道到底值多少錢？！6F 02/07 23:54
推 loadingN: 先寫起來放啊 反正離職也是要做的9F 02/07 23:58
推 s0914714: 連寫法都要詳細說明是太閒嗎?10F 02/07 23:58
推 Lhmstu: 推三樓，其實就一般分享就好，有緣人自然會想要去深究。也可以趁此機會釐清自己的思緒也不錯12F 02/07 23:59
推 abbei: 有興趣的直接看code就好了，看不懂再來問15F 02/07 23:59
→ Lhmstu: 不用特別亂寫或是藏東藏西的16F 02/08 00:00
→ tsairay: 隨便寫就好了啊,他又看不懂寫的是不是真的17F 02/08 00:00
→ fanix21: 網頁查得到的摳給他18F 02/08 00:00
推 x123392003: 大學教授也掏心掏肺在上課跟提供講義，每年還不是當一半以上的人20F 02/08 00:09
推 laiko: 同iamala！當練習表達能力也好，很多事是講慧根的~22F 02/08 00:10
→ pujos: 如果你所謂的十年經驗是寫下來看一看就會的，那...其實也沒什麼價值，要你寫下來常常只是要驗證你嘴巴講的跟做的有沒有落差而已，教會後面人，您想多了想的一套，嘴巴上說的一套，做的又是另一套的人多了23F 02/08 00:10
→ mepass: 寫的再仔細也不會有課本好啊
如果可以用上班時間寫 何樂不為
而且也不是每個員工都會那麼認真去看資料27F 02/08 00:12
→ CGDGAD: 既然是獨門，主管根本無法判斷你是不是100%分享出來了，科科33F 02/08 00:21
噓 DrTech: 這不是正常軟體公司，每天都在做的code review 工作嗎。
搞到只有某個員工懂核心程式，先要檢討"管理層太爛"，而不是工程師該怎麼講解程式碼。35F 02/08 00:22
推 urust: 2啊 點到為止 真正有興趣的人會私下主動問你的
只有在工作期間累積的專業解題經驗 才需要139F 02/08 00:26
推 dakkk: 叫他看comment42F 02/08 00:32
噓 a000000000: 隨便寫寫 反正都要閃惹 別人看不懂就酸他程度差阿 我看錯惹 以為是要離職43F 02/08 00:35
推 XinT: 如果你是一個持續會自我精進的人
根本不需要擔心別人會看到你的文件就追上你的程度。知識這種東西是因為分享而偉大
樂於分享才能讓別人知道你的厲害
技術團隊裡也往往是樂於分享的人成為團隊領袖45F 02/08 00:39
噓 shhs1000246: 你的code獨門到需要自己寫文件別人才能讀懂 連註解都不寫 我看也好不到哪裡去50F 02/08 00:45
噓 ho2002: 菜鳥在擔心這些會不會想太多??? 是有多獨門啦
這麼厲害不會自己開公司搞產品來賣????52F 02/08 00:45
10年在專業上也不是普通的菜鳥了...
我是指學無止境,每個人都有他專精的點,
都可以是某個領域的老師。
故自己永遠都是菜鳥
推 horb: 真強者一直有新突破。沒在怕的
學生時期。常常教人家解題的那幾個人。教會了越多人。自己變得越強55F 02/08 00:48
推 boy830117: 既然要寫何必亂寫？亂寫交差不就反而浪費時間？
而寫的好，對自己是練習機會，也是職場上形象加分的機會58F 02/08 00:52
→ horb: 當然如果只想爽爽過。不想紅。藏招也是辦法之一。61F 02/08 00:55
推 physicsdk: 加薪30％，寫好寫滿，不然就打打嘴砲，反正沒人比你懂，愛怎麼講都可以62F 02/08 00:59
推 boyzone66: 我就不相信主管看完你文件 就看得懂code啦 通常會講這種話的主管都是廢物 不會寫程式在那邊屁65F 02/08 01:01
推 magicmaxx: 1你如果是打算寫書出版在這樣做吧...2跟3其實都行68F 02/08 01:03
推 Iamjkc: Razavi寫電子學還需要藏一招嗎70F 02/08 01:03
推 boyzone66: 詳述各種不同語法的好壞 聽起來根本智障 以為教授在出考題喔71F 02/08 01:03
→ magicmaxx: 寫在多的教材，多數主管根本不會認真去看你寫的內容73F 02/08 01:05
推 shishah: 寫出來也不見得別人想學，老師都巴不得學生們都好好學習但很難。我是很敬佩這樣的人，曾經遇過這樣的人，他們根本不怕別人學，只苦惱別人不花時間努力精進學習跟理解，無法找到強者共同合作，凡事只能靠自己才是真正的困擾74F 02/08 01:06
→ magicmaxx: 掏心掏肺換來的只會,那新人看懂了沒,為什麼不懂
是不是你寫得不好才會他看不懂,能重寫嗎79F 02/08 01:07
推 boyzone66: 推m大 基本上看別人code就是種痛苦 無論寫得多詳細 要用別人的方式思考是件很煩人的事情81F 02/08 01:10
→ physicsdk: 主管當然自己看不懂，也壓根不想花時間讀，他期待的只是利用你的產出讓下一個找來的菜鳥能夠接你的工作，然後要嘛丟更麻煩的更多的工作給你，或是fire你用他更便宜。
換另個角度想，你沒打算在這間待一輩子，留少一點東西下來是最好的，以後跳槽用到比較不會被說是侵權或抄襲，因為前公司根本不知道自己有用XD84F 02/08 01:13
※ 編輯: truth0 (36.229.233.104 臺灣), 02/08/2022 01:27:00
推 acgotaku: 這不錯呀 我覺得每個用心的programmer都會想讓92F 02/08 01:30
推 chuegou: 我有寫 但只寫功能性的部分 語法部分沒特別寫93F 02/08 01:30
→ acgotaku: 自己的code被像藝術品一樣欣賞 解說
有些工程師對設計模式有獨特的見解 有時候聽解說
會有一種醍醐灌頂的感覺 原來這樣寫能解耦合能這樣94F 02/08 01:30
→ abyssa1: 推三樓 自己想的跟看人寫的不一樣97F 02/08 01:34
推 x52013: 看是要在上班時寫還是下班時寫，給出的東西會不一樣98F 02/08 01:41
推 pc90124: 公司的 code 時間夠 1 蠻好99F 02/08 01:45
→ uxijgil: 看寫這份文件所需要花的時間，如果還要同時開發，那就是有寫有交代就好，但不建議亂寫100F 02/08 01:55
→ lazarus1121: 1吧 寫完自己可以留著放到github上
在公司又可以給後輩秀一手 之後稱呼會變XX哥102F 02/08 02:04
→ chinggoo: 非常同意79樓的…只會落到這種下場而已104F 02/08 02:10
推 keichi: 給多少時間就寫到哪，本職不用做再來考慮1105F 02/08 02:20
推 benedict76: 這有點像寫論文，你自己想想寫論文還不是要寫這些detail，看不懂的人自然就會寄信問你了。106F 02/08 02:21
→ saladim: 有些內化的東西 除非那個東西很有印象或深刻 大概寫不太出來....因為已經太直覺了.....
另外寫到多深多少 又難拿捏 不要像Knuth書寫著寫著寫成四大本還沒寫完 @_@108F 02/08 02:23
→ overhead: 不懂你在意的點在哪？是怕講清楚被別人學走？但這不可能啊？大師的經典巨著，念得懂的有幾個人？反過來說，努力寫對方就能徹底理解的，也不是多難的知識。而且本來能清楚傳授別人，就是很有珍貴的能力，講得想施展就能施展出來似的？112F 02/08 02:27
推 TripleC: 其實我都當作寫給以後的自己看的117F 02/08 02:27
推 benedict76: 不過獨門是多獨門？自己寫的可以嘗試申請專利阿！不然也沒啥特別的。118F 02/08 02:28
→ saladim: 選2吧 寫重點就好 若是要自己用的倒是可以慢慢寫多一點 看慧根跟有沒有人想問吧(寫了還是得) 隨緣120F 02/08 02:31
噓 wayne8642: 哈哈 獨門技術....，真正厲害的人是樂於分享的，吸引能力更強的人互相分享成長，話說真正這麼獨門就去申請專利或是開公司出來賺錢了122F 02/08 03:12
→ smallcar801: 寫再認真沒人看一樣沒用，只是老闆作業績宣傳工具而已，如果真的是很多人一起合作互相引用的案子，自然而然就會每週整code的時候會有詳盡註解的要求…125F 02/08 03:14
→ wayne8642: 補充: 如果上班時間做這件事我超樂意，是要花我下班時間，我一個字都不想寫129F 02/08 03:16
推 shawnext: 教學相長，認真寫對自己的技術也會有幫助。但如果叫你下班寫就不要理他。131F 02/08 03:54
→ shawnxxx: 學黃蓉版九陰真經 一句對一句錯133F 02/08 04:15
推 miname: 先問問為什麼要做，還有沒有更重要的事情做？134F 02/08 04:44
推 wtfconk: 那種把自己會的當寶的通常都…你知道的www
敝帚自珍聽過吧135F 02/08 04:46
推 lolicat: 寫啊 但不用寫很詳細 反正接手你的人不會看 主管更不會看 心路歷程 寫空泛好聽話 幫助公司流程啦之類的
我之前工作交接 主管連安裝程式的過程都要求寫下來才有趣 不就一直下一步而已138F 02/08 05:07
推 iosian: 放心,沒人會看,當作是給自己的筆記就好了143F 02/08 05:17
推 now99: 沒專案壓力就寫啊，離職也是要寫啊，後人看懂看不懂乾工程師屁事又不是老師寫教材xd144F 02/08 05:24
→ ipoop4u: 不用藏
競爭對手是公司外的人
公司內如果你特強，那建議閃了146F 02/08 05:32
--