請問當主管要求資深RD撰寫自己經驗的文件,
請問員工該如何運對呢?
我隨便舉個例子
已寫C++語言程式為例
有個10年資歷的A員工,
常自己加班練習程式語言,六日沒事也練習程式刷leetcode,
10年下來,
累積了不少對語法的深刻了解,
把自己負責的project寫得又快又好,
主管於年前三個月,要求該員工撰寫文件詳細講解自己的code,
內文不只要能讓別的員工能接手此程式,。
(PS,原本程式內就有基本的comment和說明)
主管還要求在文件中,要詳細敘述自己當初的思考邏輯,
為什麼要這樣的寫?為什選用這語法?
和別的寫法相較差別在哪?
詳述每個寫法的好處壞處及潛在影響?
請問該如何回應比較好呢
1.掏心掏肺全部寫出來
2.保護自己,也給主管面子,寫一些,但沒寫這麼詳細
3.不認真處理這需求
小弟職場菜鳥,請各位老鳥指點
謝謝

老師電磁學的再好還是一堆人不會

看上班寫還下班寫 認真度不用一樣

選2 你主管要的其實只有能交接順利而已但這責任其實不全在寫文件跟程式的人身上

寫簡單的就好

對主管而言 維護才是最重要的 誰管你寫的多神

真正厲害的人，他的東西是一直在創新跟繼續往前的，現在努力寫下來的東西不過就是一個記錄而已，你自己也可以存下來，日後檢驗，不然古今中外留下來的資料，科技，難道都是應付長官，里長寫得嗎？別把自己想得太偉大啊

換個角度想也有可能是委婉跟你抱怨你的程式可讀性維護性有問題啊 到時你拍屁股走人他至少還可以交代之前有過作為

這種東西不用太小氣，寫了對你自己也有幫助，但我覺得這種額外授課的內容應該要跟主管談一下收一些講師費用

2

一般都會寫個readme吧 不用寫太深 之後review也方便 不過其實根本沒人會看 跑不出來會直接叫你debug