thinkdeep
V2EX  ›  DevOps

每次写完程序有没有必要写类似 wiki 的文档做记录???

  •  
  •   thinkdeep · Oct 16, 2017 via iPad · 6709 views
    This topic created in 3310 days ago, the information mentioned may be changed or developed.

    公司要求每个程序员做过一些东西都要写类似于 wiki 的文档做记录, 感觉非常没必要各位如何看,是不是很多公司都是这么做的。

    9 replies  •  2017-10-18 01:35:00 +08:00
    zhique
    zhique
    Oct 16, 2017
    1
    除了代码外,你不留下点领导看得懂的干了活的证据,怎么让领导给你升职?
    willakira
    willakira
    Oct 16, 2017❤️1
    2
    感觉非常有必要,通过类似于 wiki 的记录,你可以
    - 作为这个组的新成员,可以知道怎么设置环境,本组的大致架构是什么样子的
    - 作为其他组的成员,你可以知道这个组做的是什么事情,有事情的话找谁,如果要整合的话双方的技术实现有什么差异
    - 某些会议的记录等等
    毕竟好记性抵不过烂笔头
    组织小的时候就要养成这样的习惯,以后组织大了再搞这些成本太高了
    tonghuashuai
    tonghuashuai
    Oct 16, 2017
    3
    如果你中途接手过几个项目,并且联系不上前项目成员了,那么你就会想:为什么他们没有留文档!!!
    wuyuchenshishabi
    wuyuchenshishabi
    Oct 16, 2017
    4
    LZ 是刚工作的吧。很多外企都有专门的文档工程师。你该不会觉得鬼佬傻吧?
    PythonAnswer
    PythonAnswer
    Oct 16, 2017
    5
    注释 文档 测试...
    noNOno
    noNOno
    Oct 16, 2017
    6
    有,不然交接就痛苦了
    最讨厌的事:1 自己要写文档.2 别人不写文档
    lap510200
    lap510200
    Oct 16, 2017
    7
    非常有必要,虽然特别不想写
    thinkdeep
    thinkdeep
    OP
    Oct 18, 2017 via iPad
    8
    怎么可能刚毕业,以前公司都不会过多记录,代码规范就行,程序员应该很少写这些东西
    thinkdeep
    thinkdeep
    OP
    Oct 18, 2017 via iPad
    9
    总觉得重要的记录下,不然程序员就成为写文档的了,国外之所以有专门写文档的,可见程序员很少写,也不喜欢写,
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   1731 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 41ms · UTC 03:50 · PVG 11:50 · LAX 19:50 · JFK 22:50
    ♥ Do have faith in what you're doing.