认真请教，在公司内部认真写注释写简洁易懂的代码，同时不断写业务相关的 wiki，是不是降低自身不可替代性提高了被裁风险

wiki

认真

注释

易懂

72 条回复 • 2023-12-07 19:55:26 +08:00

1

21231sv

2023-12-04 11:52:30 +08:00

51

还是太年轻了。想裁你和你做了什么没有关系

2

72MpQOSsJhyLs88N

2023-12-04 12:09:55 +08:00

为啥你做了这么多以后职位和技能不见长进呢？

3

ccagml

2023-12-04 12:29:10 +08:00 via Android

从降本增笑来看，你是项目 owner 也没用

4

NessajCN

2023-12-04 12:33:20 +08:00

6

但凡是个正常老板都会把你这样的当宝贝
如果你老板因为你做这些把你炒了，那对你来说是个好事

5

jjx

2023-12-04 12:38:31 +08:00

4

@NessajCN

说的非常好!

其实写文档, 类似小黄鸭工作法, 对梳理自身的体系很有帮助

有些员工, 不会写文档, 写东西短而且无法阅读, 无法从中得到有效的东西, 对自己个人发展局限很大

6

twelvechen

2023-12-04 12:39:08 +08:00

5

感觉不会，leader 肯定会为自己考虑的，裁员指标优先给能力差一些的，你写的代码简洁易懂好维护，文档全，说明你能力强。代码写的差的，多 review 几次，leader 就给他打上能力差的标签了。真要裁员肯定先保对团队回报高的人，否则要不了多久这个团队就没，leader 自己也没了。

7

x86

2023-12-04 12:41:27 +08:00

1

老板：都闲的有空写 wiki 了，这么多人不写就你有这个闲空？

8

bigfei

2023-12-04 12:42:58 +08:00

1

呵呵，不是嫡系的照样裁，管你技术或者业务能力多好。还不如写的烂，弄得屎山只有你能改。
另外，老板裁人更多的是经济理由，优先裁人力成本高的，和你技术能力关系不大。

9

enchilada2020

2023-12-04 12:45:00 +08:00 via Android

在烂环境和坏风气下还有是正常人的老夫很欣慰…

10

nothingistrue

2023-12-04 12:49:51 +08:00

3

不要太过高估自己，你写的 wiki 绝大部分人，甚至还包括将来的你自己，都是不会看的。

11

feather12315

2023-12-04 12:51:39 +08:00 via iPhone

@NessajCN
@twelvechen
#4 #6
前提是，领导是个好领导，老板是个好好老板。
不然：你的活随便招一个都能干，干嘛花那么多钱招你？你存在的必要性是什么，

12

xloger

2023-12-04 12:54:04 +08:00

18

这件事其实是比较旗帜鲜明的两派的。
我的个人观点是：我又不是跟这个公司绑死在一起，我认真做事好好写代码首先是对自己负责，其次才是对公司负责。这就跟高考一样，使心眼跟同学竞争毫无意义，你的对手是整个省。
如果日常开发也是能凑合就凑合，那哪天你想写简洁易懂的代码就能信手拈来么？人的能力都是锻炼出来的。
如上面所说，裁员来的时候一般是大势，个人的这些“小技巧”无足轻重。我认为提高自己的竞争力才是关键。（可能互联网行业就不存在养老的说法吧......）

13

murmur

2023-12-04 12:55:08 +08:00

你想多了，除非你活少的长草，项目干起来认真是不存在的

14

waitingChou

2023-12-04 12:56:15 +08:00

1

代码质量和文档，实在不行接手的人花点时间啃啃代码也能熟悉。
说实话这些东西真的够不上谈替代性。

还是从其他方面考虑提升下自己的竞争力，代码文档还是该写好就写好

15

CodeCodeStudy

2023-12-04 13:10:38 +08:00

写给自己看，不要分享给别人

16

worldqiuzhi

2023-12-04 13:13:43 +08:00

又不是没接手过屎山。反编译都能啃下来，有人花钱给时间还有啃不下来的业务代码？

17

dislazy2023

2023-12-04 13:35:05 +08:00

目前正常大规模裁员不看你能力，只看你的项目挣不挣钱

18

lambdaq

2023-12-04 13:37:59 +08:00

@21231sv 其实还是有关系的。比如你那一坨代码负责核心营收，然后每天都有新需求迭代，功能开发你一个人干你一个人修。我就不信有人敢动你。

19

szdosar

2023-12-04 13:42:34 +08:00 via iPhone

看环境吧，成本优先的企业（不懂技术的 leader ）也许会这样做，而有技术情怀的企业大概率不致于这样。

20

elza

2023-12-04 13:44:41 +08:00

现在都流行写防御性代码，除了自己谁看都是一坨屎也包括自己😂

21

chenPiMeiHaoChi

2023-12-04 13:47:02 +08:00

老板根本就不关心质量，他只要表面用起来没问题。在老板看来码农满地都是换谁都一样，码农只是实现他想法的工具罢了。

22

icenine

2023-12-04 13:53:32 +08:00

真是太年轻，裁员很可能是整块业务都裁了，跟你干的好坏没关系，能写业务 wiki 在大多数外人看就是工作不饱和

23

746970179

2023-12-04 13:56:21 +08:00

1

做正确的事情就好

可替代性什么的, 不是现在的你需要纠结的
如果现在就开始故意写 shi 山, 那么恭喜你, 你的生命已经 si 了, 只是还需要三五十年才埋罢了

24

GeekGao

2023-12-04 13:59:54 +08:00

1

裁员只关心成本。人才盘点一下子，手里没啥事情成本又高的就可以砍了。你能替领导扛很多事情才是你的护身符，其他都是无用功。

25

TArysiyehua

2023-12-04 14:20:16 +08:00

我就这么说吧，除非你停止写代码项目利马就炸了，而且全公司的人都恢复不了。不然哪怕你用摩斯密码写代码也没用，因为裁你的人根本不知道你写了啥

26

lifesimple

2023-12-04 14:51:17 +08:00

想啥呢就算你变量定义成 abcd ，也没啥不可替代，又不是真掌握了啥公司赚钱的核心科技。无非就是接手的人多花点时间捋一遍捋一遍骂娘。

27

qwertty01

2023-12-04 14:53:44 +08:00

竟然还有空写注释，写 wiki 。

来人给公子上 10 个 BUG ，10 个需求，再加一个不靠谱的项目经理，啥都不懂的客户，多参加几次技术评审会议，项目交接，结项文档都搞一下。

28

HUZHUANGZHUANG

2023-12-04 15:03:19 +08:00

公司不在乎你做过什么，只在乎你还能做什么

29

jguo

2023-12-04 15:12:14 +08:00

被裁就领钱再找呗，为什么非要赖在这种 sb 公司

30

28Sv0ngQfIE7Yloe

2023-12-04 15:40:46 +08:00

稳不稳定和业务有关，和你在业务李写什么代码无关

31

ButcherHu

2023-12-04 15:41:25 +08:00

主要还是业务决定的吧，大公司可能还有站队的问题，你这个工程怎么做不起决定性的效果。
所以我倾向已经够好的就怎么简单怎么来，第一次做的就要认真做，主要是锻炼自己能力，还有增加工作效率，争取更多的摸鱼时间 doge

32

q8164305

2023-12-04 16:01:01 +08:00 via Android

纯粹想多了，你写的 Wiki 大部分情况下只有你自己看，甚至有可能你自己都不看

33

pkoukk

2023-12-04 17:11:52 +08:00

分情况，1.砍业务砍条线的时候，你干啥都裁
2.降本增笑的时候，其实先被砍的是打杂的，也就是做边缘项目的，其实和水平也没关系

34

xianzhe

2023-12-04 17:20:23 +08:00

就我自己的经历来看，老板把在上海招的优秀开发团队（都是 c9 本硕）全裁了，宁愿去别的小地方招些水平更差的人，老板是看对你的投入产出比，优不优秀是次要因素

35

thulof

2023-12-04 17:21:15 +08:00

2

良好的注释、优雅的命名、整洁的代码、详尽的 Merge Request 说明……，

这些东西并不是只对当前的需求生效，借此养成的习惯是可以使自己终身受益的

本质上是借事修人，利用公司的资源来修炼自己

36

sonLucky

2023-12-04 17:27:28 +08:00

@twelvechen 有没有可能有一部分公司是没有 review 的

37

yolio2003

2023-12-04 17:30:15 +08:00

如果说你写的好，老板缺偏要换个写的不好的替代你，还不如走了。。。

38

abelmakihara

2023-12-04 17:37:33 +08:00

无所谓的不是过于摆烂第一波被换那种
被裁的一般都是一锅端

39

aptandatp

2023-12-04 17:41:23 +08:00

你这样的老板都要裁？那这种公司没什么必要待了。

40

xiangbohua

2023-12-04 18:03:42 +08:00

1

我觉得啊，每个人被晋升、被裁都是，多方面的原因，肯定是各方博弈的结果。
你做这些肯定是好的，因为你觉得你的文档做好了，别人来了一看就懂就不需要你了，所以你的替代度降低了，所以需要藏着掖着，屎山代码只有自己知道，别人就看不懂，这样自己可替代性就上来了。这个想法我觉得有点不对了。
从两个角度看这个问题，如果你想要提升，除了写文档写 wiki 之外，还要因为你做了这些事情带来了什么，比如稳定性大大提高，项目进展很快？如果已经做到这些东西的话，反而被替代了，那我才要么你还有其他方面的能力有待提高、要么其他人更牛、要么就是老板不看人。
再反过来看问题，我看也是别人说的，如果你在一个公司别人都不写文档，就你写，那就说明这公司制度上就不看重文档。有些公司裁人早上通知下午走人，根本不考虑交接之类的，屎山代码有的是后来人看，老板们根本不在乎这些。
所以，养成写文档的习惯，有写好文档的能力，要不要真的写，真的看具体情况了

41

beneo

2023-12-04 18:06:18 +08:00

说实话，我觉得是你要晋升的节奏

42

ivslyyy

2023-12-04 18:07:37 +08:00

不能

43

ShrinkLynn

2023-12-04 19:05:36 +08:00

不是决定性原因，决定性原因是对有裁员资格的人有没有用..

44

oisadfo

2023-12-04 20:25:54 +08:00

脑回路清奇

45

bluearc

2023-12-04 21:02:45 +08:00

你写了详细的文档和 Wiki ，那老板不是更容易让其他人接手你的活了吗

46

terrysnake

2023-12-04 21:08:29 +08:00

铁饭碗的意思不是在一个地方吃一辈子饭，而是到哪个地方都有饭吃。

47

tyrantZhao

2023-12-04 21:12:57 +08:00

跟这个没关系，真正有关系的是，你和你老板之间的关系。

48

yifangtongxing28

2023-12-04 21:54:28 +08:00

在互联网，你没有写注释的时间

在外企，不认真写 cr 会不给你过，严重的给你 pip 说你代码质量太差

什么不可替代性，业务不行直接关了，喝西北风去

49

noparking188

2023-12-04 22:50:43 +08:00

代码写好点，因为后面换公司了可能还要拿过来改改用，省得又重新写了，省下来的时间可以摸鱼

50

zjuster

2023-12-04 23:29:17 +08:00

1

Exactly ，但是后面来的人也基本不会去看的

可你获得了系统性的项目经验总结、复盘，提高了自己的能力。所以坚持做对的事没问题，自己写着自己看，备着自己查阅。

实际上你忙起来的时候会发现坚持写 wiki 都是一种奢望

@lambdaq 什么公司这样的岗位只安排一个人？他休假了公司停摆？ /狗头

51

lian3204321

2023-12-05 08:57:42 +08:00

啥都不要写，真的，让你写都是在骗你的，包括开源的那套逻辑，那套只有在国外不那么内卷的社会能跑跑，国内这么内卷，一切要为自己的职业生涯服务。

52

tomatocici2333

2023-12-05 09:37:15 +08:00

裁员和技术没关系

53

playtomandjerry

2023-12-05 10:10:13 +08:00

虽然很不想说会，但是事实就是会，在不考虑其他因素的情况下，你被裁的风险会增大，特么的，好人难当，优秀的更难当

54

BBCCBB

2023-12-05 10:18:53 +08:00

如果你这样做了, 还被针对, 说明这个公司不值得你待.

但行好事, 莫问前程.

55

BBCCBB

2023-12-05 10:19:59 +08:00

提高自己的能力.

56

salmon5

2023-12-05 10:57:35 +08:00

小伙子，你还是太年轻。
你 100%分享了，没人感恩你。别人会 copy 你的分享，然后抢功替代你。有一天（态度）凌驾在你之上。

57

salmon5

2023-12-05 10:58:42 +08:00

你成了团队的客服。人工 GPT 。汇报的时候，没你一点事。

58

c2const

2023-12-05 10:59:25 +08:00

公司新人多，然后你被裁员，不管后续公司的产品、服务是否崩溃、是否"增笑"，但裁员对公司来说都是立竿见影的降本 :)
-----------------
既然有危机感，那做好跳槽准备吧 :)

59

karnaugh

2023-12-05 11:01:50 +08:00

私以为，写 wiki 这些，主要是为了来新人以后，不用事无巨细的手把手带，wiki 写的越清楚，帮新人擦屁股相对少一些，但是和你要不要被裁没有半毛钱关系

60

yukirus

2023-12-05 11:03:14 +08:00

裁你跟你可不可以替代没关系
只要老板觉得你可以替代就行，君不见 tx 的前端负责人都能被裁，你还能比人家更不可替代吗……

但你瞎写代码最后是没给自己养成好习惯，后期维护折磨的是你自己

61

whp1473

2023-12-05 11:16:50 +08:00

建议还是好好写，还有文档不质量好，数量也可以多呀，只要你多做多写，别人想读完理解完也是巨大的工作量

62

mosanHZ

2023-12-05 11:28:06 +08:00

担心那么多没用，项目都有可能被裁（参考字节游戏），你怎么防

63

a852695

2023-12-05 11:28:31 +08:00

2

冷知识：大部分公司都不是靠技术挣钱的，技术只是一个工具，真正的是商业模式挣钱了。如果商业模式跑不下去了，造火箭的技术都没啥用。

64

UIXX

2023-12-05 14:09:05 +08:00

一般公司中决策者和一线管理不会完全重合，即
[拍板裁员的管理（高管）跟直接看得到且能正确评估你成果的管理（中层打工人）不是一个人。]
在这个前提下，简洁代码、写 wiki 等技术层面努力的结果在裁员决策中充满了不确定性，吃力不讨好是常事。

你可以有一万种被裁的理由，因为写文档把自己写没了是概率很低的、典型劣币淘汰良币的烂环境。
但，为什么要因为烂环境抛弃那可贵的职业素养？你要给下一段历程以更好的自己。