
1 balabalaguguji 2023-09-18 09:18:12 +08:00 易文档,开发者写文档好帮手 https://easydoc.net |
2 Jammar 2023-09-18 09:19:27 +08:00 gpt |
3 cleveryun 2023-09-18 09:27:12 +08:00 via Android 是不是公司工作节奏慢,所以整出来这么多文档是需求 |
4 Jaosn 2023-09-18 09:28:56 +08:00 代码未动,文档先行 |
5 Davic1 2023-09-18 09:29:02 +08:00 看这个描述你讨厌的应该是给的钱太少。 |
6 carolhai 2023-09-18 09:31:35 +08:00 喂你吃个大饼,为以后总工程师积攒经验 |
7 version 2023-09-18 09:46:56 +08:00 文档不是产品写的么. |
10 wu67 2023-09-18 09:49:36 +08:00 所以我找了份没那么多条条框框的, 写不写注释都没人理, 当然, 我写注释. 至于文档, 我接手的时候也没文档, 有心无力, 还不如把注释写详细点. |
11 version 2023-09-18 09:52:57 +08:00 @lpf0309 那没办法了..企业定位不一样 普通企业产品有限..都是看成品...老板开会 => 产品记录 => 技术经理过目删减 => 评审会议 => 开发 => 测试验收完工 国企不一样.写各种文档.调研.最终要评估..审批.动手写代码应该很久很久. |
12 lifesimple 2023-09-18 09:59:48 +08:00 给时间就行,写啥不是写 |
13 flame666 2023-09-18 10:03:14 +08:00 稍微正规点的交付性项目都是必须要有文档的。 不写文档和野路子差不多。 |
14 codeself 2023-09-18 10:03:40 +08:00 国企啊,那还有啥好说的 |
span class="no">15 lpf0309 OP 我是想问问,大家都要写什么文档,好写不,如果都要写花太多时间在写文档上,我想直接放弃这个行业了。 |
16 54xavier 2023-09-18 10:25:18 +08:00 我只写开发文档还好 |
17 lpf0309 OP @codeself 都说了,干着总工的活,拿着助理工程师的工资。国企里爽的是那些机关部门,搞研发的是又要出成果,又要服从各种制度的管理。 |
18 LitterGopher 2023-09-18 10:27:16 +08:00 除了 README 其他的都不写注释应该不算文档。 |
19 lzgshsj 2023-09-18 10:30:54 +08:00 不是行业不行业的问题,你在国企任何行业都要文件俱全…… 建议换个私企小作坊那种,跟老板称兄道弟,跟同事当家人处的,可能比较适合你。代码突出一个能跑就行,需求靠口头通知,对接看微信记录,离职后哪管洪水滔天。 |
20 codeself 2023-09-18 10:32:53 +08:00 |
21 MoonWalker 2023-09-18 10:36:56 +08:00 太能理解了,什么东西没有,开个 1 小时左右的会,大概讲下背景然后就开始让你写方案设计,功能清单 |
22 wqhui 2023-09-18 10:51:44 +08:00 熟练之后就写的很快了,都是按套路写,只要时间不紧就行,一般只给生成的 api 文档用来对接 |
23 billzhuang 2023-09-18 11:06:01 +08:00 都在国企了, |
24 rehoni 2023-09-18 11:18:19 +08:00 国企了,自然什么都写,俺也一样 |
25 qiaobeier 2023-09-18 11:25:54 +08:00 用 Copilot 自动生成注释,然后用 JavaDoc 自动生成文档文件。 |
26 wobuhuicode 2023-09-18 11:29:03 +08:00 AI 文档 |
27 Cu635 2023-09-18 11:30:00 +08:00 |
28 DamonLin 2023-09-18 11:41:56 +08:00 文档还是要写的,比如一些复杂的业务场景,各种判断流程,还有对接第三方 api 引用的数据,前人种树后人乘凉。我也很讨厌写文档 |
30 taogen 2023-09-18 12:22:30 +08:00 小公司:基本没有文档 |
31 WebKit 2023-09-18 12:27:52 +08:00 via Android 我们必须写文档,任何模块都先写文档。代码有修改也要先同步到文档。我觉得挺好。可以预估更长的时间。 |
32 lDqe4OE6iOEUQNM7 2023-09-18 13:24:55 +08:00 现在有了 ai,不就几分钟的事情吗 |
33 szzadkk 2023-09-18 14:33:40 +08:00 接手一个项目的时候都希望有完善的文档,然后开发的时候都不喜欢写文档,死结,无解 |
34 luoshuimumu 2023-09-18 15:40:04 +08:00 文档还是有必要的,国企有一套严谨的验收流程,文档先行能在一定程度上起到保交付和预估风险的作用 设计文档出来了就知道能不能做出来了,不验证可行性直接撸代码只适合单打独斗的小项目 |
35 ming168 2023-09-18 15:43:26 +08:00 什么可研报告,模块报价,施工进展报告,验收文档。。。辣鸡国企 |
36 luoshuimumu 2023-09-18 15:45:19 +08:00 平时文档不算多,如果是自己写,认真写一次就行了后面可以复用。不需要一开始就严谨成文,可以做的过程中慢慢补,但是大体的设计思路和交付的关键节点要先明确下来。 文档还是有必要的,国企有一套严谨的验收流程,文档先行能在一定程度上起到保交付和预估风险的作用。 |
37 darklost 2023-09-18 17:28:47 +08:00 主要是钱给得不够 |
38 Liftman 2023-09-18 21:05:22 +08:00 你先花九块九去淘宝买一个方案、标准等等文档的合集。然后每次要写的时候。先把模板扔给 gpt 。然后再把你的细节要求扔给 gpt 。要求填充合并就行了。 |
39 plasticman64 2023-09-18 21:08:25 +08:00 蹲国企里就做好螺丝钉就行 |
40 maplezzz 2023-09-18 22:47:46 +08:00 项目可能维护的时间长,对代码健壮性,稳定性要求高的项目写写开发文档还是很有必要的;比较简单的其实不是太所谓。我现在做的有的已经维护了好几年了,有时候碰到问题翻翻之前的文档还是挺有用的。 |
41 dayeye2006199 2023-09-19 02:41:07 +08:00 不写文档不敢干活。 文档上面敲完的橡皮图章,是到时候撕逼起来的一大证据 |
42 zw1one 2023-09-19 13:51:42 +08:00 文档分有效文档和 shit 文档,你说的应该是后者。 |
43 4kingRAS 2023-09-19 14:37:07 +08:00 应届生没经历过扯皮,所以觉得文档没用,文档 邮件 纪要就跟谈生意时的合同,公章 发票一样。没出事时岁月静好,一出事时,每个字都给你翻出来看。尤其国企,你看着办吧 |