如何练习L5 to L6的写doc能力

一个简单粗暴的方法：每个 section 都加上 tldr

shuibao 发表于 2023-04-21 22:39:15
很多谷歌的人真是欠去亚麻学习锻炼一下，一些L6写的doc也不咋样一坨狗屎

人家说不定是躺平了，随便糊弄一下。
在亚麻是没办法，来了🐶，环境不要求，为啥还要执着于这种工具性的东西。
资本定义的种种标准是为了把人变成了工具。很多人还趋之若鹜，把它标榜成能力，自己贴标签。一味追求虚假的优越感，而忽略了自己付出的高昂的代价。

我觉得其实就是需要一个concise的abstract, 几句话把文章的基本逻辑概括出来，最好再配一个图， 这样高L就在第一页得到了overview,然后可以根据他们自己的知识脑补细节， 继续读下去就轻松很多。 现在docs Gen Ai 有summarizes 的feature, 有时候概括的挺好。 可以试试

补充内容 (2023-04-23 00:34 +08:00):
我现在每写一段话都要用docs gen ai rephrase. 真的很强大

现在ChatGPT 那么会写
我有疑问，能不能让ChatGPT 代写？
我们只需要提供自己想说的idea

匿名用户 发表于 2023-4-22 09:33
现在ChatGPT 那么会写
我有疑问，能不能让ChatGPT 代写？
我们只需要提供自己想说的idea

我manager就用chatGPT写一些Doc，我读的时候发现比较空洞，车轱辘话来回说，适合填充字数

今年都明确说L6升职大幅减少了，我已经想躺平了，不去挤这个独木桥受这个罪了

fanttfw_2020 发表于 2023-4-21 21:06
技术是为了需求服务，把重点放在如何满足需求上而非逐字逐句解释技术细节。

清晰的思路是从需求开始到满足 ...

把商业需求搞明白，解决了什么问题说清楚。围绕着这个说。

shendaodao 发表于 2023-4-22 08:54
今年都明确说L6升职大幅减少了，我已经想躺平了，不去挤这个独木桥受这个罪了

大不了创业去呗，熬成个甩手掌柜也不错。。

写doc能力不是个事，关键是要先搞清看doc人的企图
从老板想要的结论倒着写，英文叫“top-down" 蕉厂叫 PRFAQ，让领导看到英雄所见，感觉到她自己伟大
写doc和写码正好相反，写码是"bottom-up"最后写main，"bottom-up"写doc两种可能结论： 要不跑偏，要不太多（==没有）
小技巧，留几个spell/grammar错，让领导有意见可提，LZ升值指日可待

dyb_td 发表于 2023-4-22 12:29
我觉得其实就是需要一个concise的abstract, 几句话把文章的基本逻辑概括出来，最好再配一个图， 这样高L就 ...

请问用的哪个工具rephrase？谢谢。