研发经理安排我学习一个新技术为了之后的项目做准备,然后我说“好,弄好后我整理一个技术文档分享一下”,研发经理说“整理文档又没人看。” - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
yag
V2EX    问与答

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

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

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

    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     Solana     2750 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 27ms UTC 02:02 PVG 10:02 LAX 18:02 JFK 21:02
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86