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

总感觉文档弄的越好 越是给自己挖坑

  •  1
     
  •   loliordie · 21 天前 · 1565 次点击

    接了个烂尾项目 文档完全没有 服务运行在哪里都不知道 完全是自己一点点看代码才把结构梳理下来 然后按照自己的习惯写好文档 甚至还做了完整的流程图和每个模块的流程图

    结果看下来感觉完全是给自己挖坑 有了这个文档随便找个实习生就边做边学接替我了...我本来还想找时间看一下 SWIFT 现在估计过不了多久老板就会发现随便找个人就能替代我 可以把我继续扔到其他开发项目干苦力...

    是不是以后做项目自己搞个文档给自己看 让整个项目都是个黑箱 离了我不行那种...离职或者换组再交出文档...

    13 回复  |  直到 2019-11-20 15:17:33 +08:00
        1
    loading   21 天前 via Android
    如果你真的比实习生强很多,你就不会有这种顾虑。
    实习生摸着
        2
    loliordie   21 天前
    @loading 我本来还想趁着维护项目的闲工夫学一下 swift, 文档弄好了被抓去继续填坑压根没时间学新东西
        3
    loading   21 天前
    如果你上班时间能有充足的时间学东西,那你真的还是个实习生。
        4
    loliordie   21 天前   ♥ 1
    @loading 逗, 难道你以为上班就是一直写业务代码? 难怪是个实习生

    学新技术并应用到自己项目上本来就是职责之一, 也就码畜一天到晚写 if else 嵌套的辣眼睛业务代码.
        5
    loading   21 天前 via Android
    @loliordie 所以你认为没空就是因为一直在写代码?
        6
    Acoffice   21 天前 via Android
    首先楼主可能在现公司没找到认同感,
    其次想通过这些努力,得到嘉奖,然后才会更卖力,外部驱动型,不然内心无法得到平衡.
    ---
    学会自己肯定自己,没有外部奖励机制,那就自己奖励自己.
    到底是当矛还是当盾,需要自己下决心.
    其实勇往直前,有时候还是挺难的.
    ---
    其实我在说我自己,总觉得这时有个人引导我就好了,但事实上绝大多时候还是要自己走,注定没人引导.
        7
    tt67wq   21 天前
    整理文档也算工作!让他们给排期,时间短了就不出文档!
        8
    12tall   21 天前
    哇 楼主很厉害啊 手工点赞

    个人觉得找个实习生顶替有觉悟的员工长期来看还是有点亏的吧,可惜我并不是老板~~~
        9
    fancy111   21 天前
    除非是必须给其他人维护,不然要我写文档是不可能的。一套系统基本上一天时间就能摸透逻辑,没必要文档。
        10
    sparrww   21 天前
    其实这种情况很普遍,你解决公司问题了,公司对你并没有奖励机制和任何表示。总的来说就是公司 leader 并不懂技术的重要性,如果钱再给的不够趁早撤,反正不重视技术的长期呆着也没啥发展。
        11
    passerbytiny   21 天前
    文档弄的越好,越是给自己挖坑
    文档弄的越差,更是给自己挖坑
        12
    zr8657   21 天前
    我写注释只写自己能看明白的东西,文档只写一眼就能看出来的正确的废话,这样既可以让自己想起来,又相对不那么简单明了,感觉算是个折中的方案。都是生活逼的
        13
    lewinlan   20 天前
    同意 11 楼,不写注释更是给自己挖坑。
    有的时候回头看几个月前写的代码,特别是业务逻辑复杂的,要是没文档根本看不懂了……
    命名和文件组织结构也很重要。

    换项目干苦力活也不全是坏事,至少丰富了项目经验不是?
    关于   ·   FAQ   ·   API   ·   我们的愿景   ·   广告投放   ·   感谢   ·   实用小工具   ·   3421 人在线   最高记录 5043   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.3 · 39ms · UTC 04:22 · PVG 12:22 · LAX 20:22 · JFK 23:22
    ♥ Do have faith in what you're doing.