額 這種要求還是第一次聽到
如果是畫畫UML圖
講一下各系統的關聯 讓新接手的同事能快速上手
這個是滿正常的
有底子的人看圖再自己追code就夠了
可是要寫到為什麼選這技術
為什麼用這演算法
這個講不完耶 要講可以講很深
不懂主管要你做這個的用意
要嘛就準備個報告 分享給全team的人
有問題直接問 這樣比較好吧
有些東西是靠經驗的
我覺得這裡有資安風險 或是這裡可能是流量瓶頸
就會多做些保護措施
只可意會不可言傳
如果用講的就能懂 那幹嘛還要資深RD
要分享當然能分享啊
問題是學得人功力不夠
也聽不懂為什麼這樣做 那等有興趣的人自己來問不是比較好
至少他知道這裡是有竅門的 這時候的分享才有價值
不然你叫一個資深架構師 分享大流量網站設計經驗
結果底下都是新手 根本不知道這個東西厲害在哪
還不如寫個簡單的文件讓大家看得懂就好
所以這題是要看情況
如果同事都是高手 就寫詳細一點
如果新手居多 就寫些需要注意的點就好