V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
yag
V2EX  ›  问与答

研发经理安排我学习一个新技术为了之后的项目做准备,然后我说“好,弄好后我整理一个技术文档分享一下”,研发经理说“整理文档又没人看。”

  •  
  •   yag · 2018-04-11 10:18:01 +08:00 · 2530 次点击
    这是一个创建于 2418 天前的主题,其中的信息可能已经有所发展或是发生改变。

    这句话把我伤到了,各位学了新技术给给公司同事分享的时候是通过什么呢? 像我一样整理文字?还是给他弄个可视化页面? 难道整理文档还有错么 心烦的要死。

    13 条回复    2018-04-12 14:32:12 +08:00
    zyqzyq08
        1
    zyqzyq08  
       2018-04-11 10:24:43 +08:00   ❤️ 1
    整理了放 git 上,看的人只会多不会少。
    wormcy
        2
    wormcy  
       2018-04-11 10:28:05 +08:00
    总结成一个 slide,项目开会的时候介绍一下?
    Rysle
        3
    Rysle  
       2018-04-11 10:28:32 +08:00
    直接开现场分享
    nullcoder
        4
    nullcoder  
       2018-04-11 10:29:31 +08:00
    文档是不会看的,show me the code
    yag
        5
    yag  
    OP
       2018-04-11 10:31:13 +08:00
    @zyqzyq08 我也想如此来着,既然公司的人不看我不如分享给更多的人,但是既然是在公司写的文档,光明正大的放到 git 上好吗
    iyaozhen
        6
    iyaozhen  
       2018-04-11 10:37:12 +08:00 via Android
    估计你们理解有偏差。主要是这里的文档是什么?官方文档+ hello word ?这样确实意义

    上级肯定是希望有一些深入的,比如如何落地到现在的项目中
    yag
        7
    yag  
    OP
       2018-04-11 10:47:43 +08:00
    @iyaozhen 其实我知道我的 leader 是什么意思,之前我整理过一个我们常用的第三方接口文档但是没人看,我们这个 leader 入职之后就把接口做成了可视化,但是还是没人看,最后直接把接口全整合进了一个项目,供其他项目组的同事测试调用,然后把我写的文档有分类写成了 html 静态页面,我是觉得这种上赶着给别人提供服务不好
    NonClockworkChen
        8
    NonClockworkChen  
       2018-04-11 10:51:16 +08:00
    一般学习新技术,还是喜欢看官方 tutorial,怕被带跑偏。
    binux
        9
    binux  
       2018-04-11 11:03:38 +08:00 via Android
    就算没人看,你不整理个文档,怎么证明你真的学过了?
    green15
        10
    green15  
       2018-04-11 11:16:54 +08:00 via iPhone
    整理文档是自己学习的一种方式。
    yzq007
        11
    yzq007  
       2018-04-11 16:16:53 +08:00
    我们领导就喜欢整理文档,只能说看个人了
    zyqzyq08
        12
    zyqzyq08  
       2018-04-12 09:50:24 +08:00
    @yag 你可以选择在公司看新技术,然后回家写文档,也能当做一次复习,回家写的文档应该是能发的。。。纯属个人建议
    forestyuan
        13
    forestyuan  
       2018-04-12 14:32:12 +08:00
    同意 8 楼,别人要学当然是看官方文档了,一来怕你水平不够理解有偏差,二来如果版本升级快,可能最新版跟你的文档已经相差很多了
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2808 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 12:54 · PVG 20:54 · LAX 04:54 · JFK 07:54
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.