• 请不要在回答技术问题时复制粘贴 AI 生成的内容
huangdaxian
V2EX  ›  程序员

如何优雅地撰写交接文档?

  •  2
     
  •   huangdaxian · Jul 24, 2018 · 14100 views
    This topic created in 3024 days ago, the information mentioned may be changed or developed.
    Supplement 1  ·  Aug 7, 2019
    这是我去年提的问题,去年文档就写得不咋样,今年又到了写交接文档的时间,希望再来讨教一波经验。
    36 replies  •  2019-08-07 15:59:08 +08:00
    zyp0921
    zyp0921
    Jul 24, 2018
    1
    同问
    justdoit123
    justdoit123
    Jul 24, 2018 via iPhone
    2
    嘲讽一下:“一切都在代码里”
    qingmiyang
    qingmiyang
    Jul 24, 2018
    3
    同问
    JokerHuang
    JokerHuang
    Jul 24, 2018
    4
    “看代码好了”
    lazypu
    lazypu
    Jul 24, 2018
    5
    结合原型看代码, 告辞
    dalibaxiaoliba
    dalibaxiaoliba
    Jul 24, 2018 via Android❤️2
    6
    “我来的时候也没啥文档啊”
    crayygy
    crayygy
    Jul 24, 2018 via iPhone
    7
    吐槽一下说一切看代码,我来的时候也什么都没有的,那还要个毛的交接?交接中的东西基本上可以认为是你在这期间所做的事情的最精炼的总结,写成文档才是对自己的负责态度。
    zjsxwc
    zjsxwc
    Jul 24, 2018
    8
    交接文档不都是走个过场吗?给人事看的吧。


    电脑主机:1 台
    键盘:1 个
    鼠标:1 个
    显示器:2 个
    在职期间创作的代码:已在公司 git 托管,git 账号已移交主管,如以后有什么不懂可联系我 qq:xxxxxx




    以上
    Hucai
    Hucai
    Jul 24, 2018
    9
    当年离职,领导不仅让把工作内容、进度留下,还要把掌握的知识点留下,整理成文档给新人
    jianpanxia
    jianpanxia
    Jul 24, 2018
    10
    离职可能有三种情况
    1. 愤怒离场,从此相逢成路人
    2. 离不离职都一样,反正都是工作,就普通应对
    3. 离职之后还是好朋友,没事回来喝喝茶,吹吹水

    看选择哪种咯~~
    mentalkiller
    mentalkiller
    Jul 24, 2018
    11
    @Hucai #9
    这怕不是交接了,这怕是在帮领导培养新人了
    huangdaxian
    huangdaxian
    OP
    Jul 24, 2018
    12
    @zjsxwc 这是行政交接的文档,项目也要交接的啊
    huangdaxian
    huangdaxian
    OP
    Jul 24, 2018
    13
    @jianpanxia 我想离成第三种,公司食堂还是蛮不错的。可惜领导挽留着挽留着要变成第一种了。
    jimliang
    jimliang
    Jul 24, 2018❤️1
    14
    『代码即文档』
    maichael
    maichael
    Jul 24, 2018
    15
    主要看你离职的原因还有接你锅的人跟你关系怎么样。

    其实如果不是项目太复杂,或者项目转手太多次导致代码太脏,只要简要的写关键点就行了。
    huangdaxian
    huangdaxian
    OP
    Jul 24, 2018
    16
    @maichael 代码不脏,但业务涉及多系统,我怕别人无法理解我的设计思维。

    因为平常我们开发留下的文档也是很少的。
    nicolas0caser
    nicolas0caser
    Jul 24, 2018❤️1
    17
    基本上就是:以前做过什么(完成的,未完成的),现在在做什么(进行中),未来要做什么(提交到项目日程中的),这三部分了。类似写了几天高考作文,又重温了一下议论文的三段论。

    一直觉得我司没有知识沉淀或者没有统一平台,所以入职后怂恿领导搭了一套内部知识共享平台,所以,很多时候身边小伙伴离职时,写文档也轻松了许多,直接在里面写,用到的链接,直接引用内部链接、以前自己总结过的项目 /知识链接等等,整个世界都清净了。离职的小伙伴开开心心,入职的小伙伴开开心心。
    zjsxwc
    zjsxwc
    Jul 24, 2018❤️1
    18
    @huangdaxian #12

    项目交接?

    前端有什么好交接的,看代码呗,汗。

    后端最多写个文档解释下数据库表用途、主要的业务代码拎 2 个出来说明下。

    说实话接收文档的人能不能看懂项目是他自己的事情,关交接什么事。

    如果闲字数不够就把项目里用到的框架的官方文档扒过来改下标题也一起复制黏贴上去,这是我一个外包朋友的做法。
    lizz666
    lizz666
    Jul 24, 2018
    19
    刚写完交接文档
    zhaogaz
    zhaogaz
    Jul 24, 2018
    20
    大概就是把自己做过的东西整理成文档。给下一个需要用的人。。

    没 sha 优雅的
    wobushizhangsan
    wobushizhangsan
    Jul 24, 2018 via Android
    21
    我来的时候接手项目啥文档都没有,我走的时候还得写文档
    fin123
    fin123
    Jul 24, 2018❤️1
    22
    罗列接手过的项目,提供以下信息
    - 项目 git 地址
    - 发布系统对应地址
    - 产品、接口、设计文档地址
    - 前端、后端、产品、测试相关人员信息
    sampeng
    sampeng
    Jul 24, 2018
    23
    “看代码好了”
    YMB
    YMB
    Jul 24, 2018
    24
    有人跟我说 吃泡面不健康 我就笑了
    我 TM 都混到吃泡面了 还管它健不健康
    ferock
    ferock
    Jul 24, 2018
    25
    @sampeng +1
    @YMB +1

    其实我也想优雅的写接口文档,可惜,我司这块并不计入考核 kpi。
    jrient
    jrient
    Jul 24, 2018
    26
    这样
    你就把你代码是你马上要出嫁的女儿,
    你的女婿是头猪,
    然后你就交代吧,每个细节都交代清楚了,你才能放心的让她嫁过去。
    Yuansir
    Yuansir
    Jul 24, 2018
    27
    都在公司 gitlab 上
    Light3
    Light3
    Jul 24, 2018
    28
    代码都有注释
    没啥要交接的啊
    Biexl
    Biexl
    Jul 24, 2018
    29
    欢迎入坑
    cuzfinal
    cuzfinal
    Jul 24, 2018
    30
    talk is cheap, look at the code
    告辞
    ofooo
    ofooo
    Jul 24, 2018
    31
    @nicolas0caser 内部知识共享平台用的什么框架? 我也想弄个自己的~~~
    nicolas0caser
    nicolas0caser
    Jul 24, 2018
    32
    @ofooo PHP 团队的小伙伴们基于 dokuwiki 二次开发
    mingyun
    mingyun
    Jul 24, 2018
    33
    @nicolas0caser dokuwiki 这个我们团队在用
    cnfeat
    cnfeat
    Mar 4, 2019
    34
    如何写好离职工作交接文档? - 知乎
    https://zhuanlan.zhihu.com/p/27434051

    之前写过一篇类似文章,可供参考
    balabalaguguji
    balabalaguguji
    Jun 12, 2019
    35
    有专门写技术文档的工具的,你可以试下 easydoc.xyz
    效果优雅,编写方便
    huangdaxian
    huangdaxian
    OP
    Aug 7, 2019
    36
    @balabalaguguji 不太适合,并不缺工具,只缺思路
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   1558 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 87ms · UTC 17:43 · PVG 01:43 · LAX 09:43 · JFK 12:43
    ♥ Do have faith in what you're doing.