额 这种要求还是第一次听到
如果是画画UML图
讲一下各系统的关联 让新接手的同事能快速上手
这个是满正常的
有底子的人看图再自己追code就够了
可是要写到为什么选这技术
为什么用这算法
这个讲不完耶 要讲可以讲很深
不懂主管要你做这个的用意
要嘛就准备个报告 分享给全team的人
有问题直接问 这样比较好吧
有些东西是靠经验的
我觉得这里有资安风险 或是这里可能是流量瓶颈
就会多做些保护措施
只可意会不可言传
如果用讲的就能懂 那干嘛还要资深RD
要分享当然能分享啊
问题是学得人功力不够
也听不懂为什么这样做 那等有兴趣的人自己来问不是比较好
至少他知道这里是有窍门的 这时候的分享才有价值
不然你叫一个资深架构师 分享大流量网站设计经验
结果底下都是新手 根本不知道这个东西厉害在哪
还不如写个简单的文件让大家看得懂就好
所以这题是要看情况
如果同事都是高手 就写详细一点
如果新手居多 就写些需要注意的点就好