V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
wangbenjun5
V2EX  ›  程序员

大厂程序员的文档 PPT 能力非常重要

  •  1
     
  •   wangbenjun5 · 2021-08-23 17:08:49 +08:00 via Android · 4139 次点击
    这是一个创建于 1187 天前的主题,其中的信息可能已经有所发展或是发生改变。
    在福报厂干外包干了 1 年多,偶尔没事翻了翻语雀上面的各种文档,不禁感叹这些 p7,p8 大佬的文档能力,尤其是里面的各种思维导图、架构图,甚至 PPT,写的真好。

    即使是一个普普通通的功能模块,没有涉及什么特别复杂的技术,但是只要那个架构图一画,各种颜色的模块,箭头指来指去,虽然看不懂,但是感觉很高大上的样子,很牛逼。

    如果没有图,看起来就索然无味,平淡无奇,即使写的文字再多。

    大佬们的述职报告更是无比奢华,看完之后再看看我以前写的,那就是小学作文。终于知道为什么大佬经常让我做一些白屏化的功能,原来是为了放在 PPT 里面给领导看的。
    21 条回复    2021-08-31 10:09:26 +08:00
    Oktfolio
        1
    Oktfolio  
       2021-08-23 17:20:08 +08:00   ❤️ 5
    一坨屎都能给你吹得喷香
    kzhangWhy
        2
    kzhangWhy  
       2021-08-23 17:27:05 +08:00   ❤️ 1
    虽然看不懂,但是感觉很高大上的样子
    ~~~~~~~画图不就是为了让人更容易看懂嘛,为了好看,搞得复杂的让人看不懂来体现自己的水平?那怪要 996 福报了
    nnqijiu
        3
    nnqijiu  
       2021-08-23 17:32:39 +08:00   ❤️ 1
    画图就觉得高大上,让人觉得你的东西牛逼
    qwerthhusn
        4
    qwerthhusn  
       2021-08-23 17:40:45 +08:00   ❤️ 7
    底层码农用 IDE 工作,高级的用 Office 工作,顶级的用嘴工作
    wangbenjun5
        5
    wangbenjun5  
    OP
       2021-08-23 17:42:58 +08:00 via Android
    @kzhangWhy 这你就不懂了,一眼就看明白的东西还怎么拿出来吹啊,1+1=2 的 PPT 你感兴趣吗?
    4ark
        6
    4ark  
       2021-08-23 18:02:52 +08:00
    学到了
    66450146
        7
    66450146  
       2021-08-23 18:14:47 +08:00
    工程师的两大技能:

    1. 把复杂系统用简单明了的方式表达出来,让不熟悉的人可以快速理解系统的主干。这个在代码上很难读出来(很费时间),因为每个文件在浏览器里占的位置都一样大,而且文件行数也不能代表它的重要性。

    2. 把现实问题用抽象的方式表现出来。

    两个技能落实下来都是做胶片
    Tumblr
        8
    Tumblr  
       2021-08-23 18:22:44 +08:00   ❤️ 5
    本来表达也是一种能力,包括求职的时候同样的一件事情,简历上怎么写,带来的效果也不一样。

    - 帮同事检查代码,修改其中的错误。
    - 帮同事审校和优化代码

    一件事两样说。
    lzfnb
        9
    lzfnb  
       2021-08-23 18:51:41 +08:00
    可以去美团看看,不写文档=没干活
    b00tyhunt3r
        10
    b00tyhunt3r  
       2021-08-23 18:52:24 +08:00 via iPhone
    本来就是这样的
    归纳与表达本质是逻辑思维能力的体现
    x940727
        11
    x940727  
       2021-08-23 18:58:16 +08:00
    问题是……图这种东西相比文字文档来说微不足道吧(除了介绍架构的时候会用一下),开源界我见过质量最顶级的文档就是 Spring 和 Apache 基金会的项目文档了,那突出一个文字多。
    x940727
        12
    x940727  
       2021-08-23 19:00:47 +08:00
    从支付宝和微信支付的对接文档里面,我对这些大厂程序员所谓的文档能力那是相当质疑的。除了流程图画的还算清楚,文字表达上简直弱鸡到令人发指,各种东西都是东一块西一块的,感觉好像一个文档是十几个人一人写一块,还没有人把握总章的那种。
    wangbenjun5
        13
    wangbenjun5  
    OP
       2021-08-23 19:10:38 +08:00 via Android
    @x940727 你说的这个文档可能是外包写的,而且还是很多波人写的,哈哈
    gouflv
        14
    gouflv  
       2021-08-24 00:00:38 +08:00 via iPhone
    @x940727 大佬怎么会有空写你说的这种文档
    x940727
        15
    x940727  
       2021-08-24 09:36:25 +08:00
    @gouflv 支付对接的开发文档这还不够重要?合着写代码和写文档的是两批人?还是说微信支付和支付宝都是外包做的?
    wangyzj
        16
    wangyzj  
       2021-08-24 10:25:15 +08:00
    向上管理的手段
    你即使再牛逼没有这种向上管理的手段依旧升不上去
    再伞兵,ppt 写得好依旧功劳都是你的
    gouflv
        17
    gouflv  
       2021-08-24 12:19:57 +08:00 via iPhone
    @x940727 你觉得重要 那就重要吧
    x940727
        18
    x940727  
       2021-08-24 12:26:55 +08:00 via iPhone
    @gouflv 嗯,不重要,一点都不赚钱。
    8355
        19
    8355  
       2021-08-24 14:08:14 +08:00
    你述职讲的好 领导也有汇报材料, 你的产出就是领导的产出, 你做的再好讲不出来领导怎么帮你汇报呢...这不就是打工人的基本变现能力, 就像你可以写一个好简历一样,可以让看简历的人心情愉悦.不敢说一定可以增加录用概率, 但起码面试机会是一定有的,这个能力到哪都适用啊.
    xylxAdai
        20
    xylxAdai  
       2021-08-24 16:54:21 +08:00
    @x940727 确实是这么写的,都是负责那个模块的写那个模块的接口.
    lap510200
        21
    lap510200  
       2021-08-31 10:09:26 +08:00
    先把开放平台文档补全,把接口规范统一,把 bug 修复,再扯别的
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2792 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 23ms · UTC 13:05 · PVG 21:05 · LAX 05:05 · JFK 08:05
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.