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

不看文档的前端我真的很反感

  •  1
     
  •   brader · 287 天前 · 9996 次点击
    这是一个创建于 287 天前的主题,其中的信息可能已经有所发展或是发生改变。
    就一个接口签名机制,我已经详细的给出了签名步骤的文档,并辅助性的给出了服务端版的代码示例实现(抱歉我没有能力提供 objective-c 版本的),两位女同志 IOS ,第一次接入不细看文档,反反复复的问我忍了,接入过程中喜欢截图提供 objective-c 的代码报错好似让我给她 debug 一样我也忍了。
    这套签名机制上线以来,她们已经接入超过 3 个项目了,今天大早上还有个人来问我这样的问题,我真的不知道怎么吐槽好,我觉得这已经不属于技术范围的问题了,这是纯不看文档



    部分文档截图:
    第 1 条附言  ·  286 天前
    今天早上我又有被气到,发你们看下,拿我时间来给她省时间
    109 条回复    2023-09-07 11:08:21 +08:00
    1  2  
    wuvvu
        1
    wuvvu  
       287 天前   ❤️ 12
    这种人就是觉得问人是最容易解决问题的方法,不会自己先想办法解决的
    shizaia
        2
    shizaia  
       287 天前
    她们领导应该不懂代码,大概绿是个男领导。
    gongxuanzhang
        3
    gongxuanzhang  
       287 天前
    不能跟她说"你去看文档"吗
    w210934618
        4
    w210934618  
       287 天前   ❤️ 4
    统一回复:去看文档 不就行了 大男人叫她们看文档 这句话说不出口? 美女同事随意
    shadowyue
        5
    shadowyue  
       287 天前   ❤️ 11
    no ,是不看文档的任何开发都令人反感
    mb4555
        6
    mb4555  
       287 天前
    不能跟她说"你去看文档"吗
    wednesdayco
        7
    wednesdayco  
       287 天前
    作为一个前端我也很反感不看后端文档的前端
    kaz10025
        8
    kaz10025  
       287 天前
    我们这也不少...做了好几个项目 每次都问低级问题
    Mexion
        9
    Mexion  
       287 天前
    很多人就是不看文档.jpg
    visper
        10
    visper  
       287 天前
    rtfm
    Asakijz
        11
    Asakijz  
       287 天前   ❤️ 1
    你只要解答它们一次,下次还会再来找你。
    第一次就应该让他们直接看文档。
    luomao
        12
    luomao  
       287 天前
    确实,不仅不看文档,而且有啥问题还像你欠他一样。我说你不看文档么,他说“是的,我瞎了,行了吧,不用对接口了”。真真的,这种人我都是能不对接就不对接,管好自己的一亩三分地,文档写清楚自己问心无愧
    JeongReich
        13
    JeongReich  
       287 天前 via iPhone   ❤️ 6
    伸手党永远不会意识到自己是有问题的
    estk
        14
    estk  
       287 天前   ❤️ 5
    工作群回复并 at 她,回复内容为你文档出处截图,问一次回一次,每次都文档截图,最好附上文档链接
    也不要抱怨她为什么不看文档,反正回复就是文档截图+链接,懂的人都懂,也不需要跟不懂的人浪费口舌
    estk
        15
    estk  
       287 天前
    @estk #14
    当然,有很大的概率她会觉得你查文档快,每次都让你帮她查
    dyllen
        16
    dyllen  
       287 天前   ❤️ 1
    说真的,前端很多这样的人。
    jones2000
        17
    jones2000  
       287 天前   ❤️ 56
    这有什么好反感的,都是同一个公司的, 还能混个脸熟。 日报里面都可以写,“ 协助兄弟部门联调前端签名问题。(工时 3 小时)”
    clieujv
        18
    clieujv  
       287 天前
    @jones2000 你是懂工时的
    shaozelin030405
        19
    shaozelin030405  
       287 天前
    问一下他们看文档没
    iold
        20
    iold  
       287 天前
    这种我都会回复,内容是文档的截图,多一个字都不会写。
    manning
        21
    manning  
       287 天前   ❤️ 1
    bojackhorseman
        22
    bojackhorseman  
       287 天前
    不是写 js 的咱前端不认哦🐶
    crazyTanuki
        23
    crazyTanuki  
       287 天前
    原生开发不是前端🐱
    mango111
        24
    mango111  
       287 天前
    这不是客户端吗?哪来的前端
    oxromantic
        25
    oxromantic  
       287 天前   ❤️ 7
    说个题外话,你们这个 code 设计的好别扭,既然参考 http 200 视为成功,为啥 302 又是需要登录。。401 给参数错误用了,实际上参数错误 400 更合适
    streamrx
        26
    streamrx  
       287 天前 via iPhone
    你别回答他问题,直接让她们滚去看文档就行了 , 惯的
    des
        27
    des  
       287 天前 via iPhone
    @mango111 客户端也可以算作前端,不只是 web
    lambdaq
        28
    lambdaq  
       287 天前
    你就把事情搞大,拉他领导开电话会议商讨这个错误码应该如何定。
    brader
        29
    brader  
    OP
       287 天前
    @oxromantic 本业务码不遵循 HTTP 状态码规范,不要过渡解读和映射,按文档实现即可。
    我可以给你讲讲我这么设计的心里想法,其实我整个项目的 API 响应,应该有 95%以上都是都是响应 200 、400 的,出于特殊响应需要、调试需要、对接阶段会频繁出现的错误的情况,独立出了 200 、400 之外的一些特殊业务码,项目正常上线后,我观测线上 LOG ,其实是几乎没有特殊码出现的。
    孰优孰劣,个人看法,不喜勿怪
    z1645444
        30
    z1645444  
       287 天前 via Android
    不管是什么方向的开发,主打伸手还觉得理所应得,真的很恶心😡
    noreplay
        31
    noreplay  
       287 天前 via Android   ❤️ 1
    @shizaia 这个绿字就很灵性了😂
    buffzty
        32
    buffzty  
       287 天前
    我是后端 我所有的接口都是 post+json , 不然就等着被问吧 为什么我接口 404 啊
    1016
        33
    1016  
       287 天前   ❤️ 1
    请你分清楚工种 谢谢您勒,前端是前端,ios 是 ios ,安卓是安卓。而不是 ios 和安卓都归于前端😅
    8355
        34
    8355  
       287 天前
    文档截图+链接发群里啊。
    当然是要包容(公开处刑)了
    mango111
        35
    mango111  
       287 天前
    @des 这下大前端了
    fantathat
        36
    fantathat  
       287 天前 via iPhone
    也许人家并不知道你的文档有写,或者并不知道要看文档,或看文档更有益于解决,也不知道直接问你对接会引起你反感,毕竟接口对接需要接口,而接口的定义人家并不知道而又需要
    brader
        37
    brader  
    OP
       287 天前   ❤️ 1
    @fantathat 这个就纯属笑话了,我上面说了,这套机制接入超过 3 个项目了,第一次提供文档的时候,发群里了,客户端以前已经实现过这套机制了,你说没看过那份文档,真就是借口了
    litchinn
        38
    litchinn  
       287 天前
    例会上直接提出,并以退为进
    “关于错误码的定义,我发现在经过三个项目之后,仍有部分同事对此并不完全了解,我希望能充分了解这部分同事对文档的疑问,以及使用上到底有什么问题,文档是否完善,是否需要令相关人员共同商议协定新的错误码定义,并重新完善文档”
    Mithril
        39
    Mithril  
       287 天前
    他们就是把你当 ChatGPT ,对于有的人来说,浪费别人时间是没有成本的,而且节省了自己翻文档的时间。

    你要是不想起冲突,那就每次延迟 2~4 小时再回复他。
    o562dsRcFqYl375i
        40
    o562dsRcFqYl375i  
       287 天前
    有没有一种可能,她们想追你 doge
    debuggerx
        41
    debuggerx  
       287 天前
    我写前端的时候,可不咋看后端文档,
    因为我会直接看后端代码,从而得到最准确的参数和规则,以及返回数据结构及各种可能的情况……
    甚至我会建议后端不用浪费时间维护文档。。
    changepll
        42
    changepll  
       287 天前
    @huangzongzhuan 那就拿钱砸. 不要折磨他. 哈哈
    aduangduang
        43
    aduangduang  
       287 天前
    所以我会在返回 code 的同时,把错误描述也返回
    ChefIsAwesome
        44
    ChefIsAwesome  
       287 天前
    最烦发个截图的。我就是看得懂,也复制不了啊。
    ltfree
        45
    ltfree  
       287 天前
    @jones2000 学习了哥
    smile2wild
        46
    smile2wild  
       287 天前   ❤️ 3
    现在居然有后端写文档,我们公司后端都没文档的
    fregie
        47
    fregie  
       287 天前
    遇到这种我直接无视的,不能因此浪费自己的时间和情绪
    tinyfry
        48
    tinyfry  
       287 天前
    哈哈 直接文档丢过去
    zy0829
        49
    zy0829  
       287 天前
    @debuggerx 你去看后端代码不是也需要时间吗
    debuggerx
        50
    debuggerx  
       287 天前
    @zy0829 最少代码不会骗人,我最烦照着文档写半天调试半天,最后才发现是文档和代码对不上
    qb20150806
        51
    qb20150806  
       287 天前   ❤️ 1
    不好看的让去看文档,好看的手把手教🐶
    7inFen
        52
    7inFen  
       287 天前   ❤️ 2
    不看文档的后端我也很反感,明明是个 nunber ,传个 string 过来
    cnoder
        53
    cnoder  
       287 天前   ❤️ 2
    文档不更新及时的后端我真的很反感
    cnoder
        54
    cnoder  
       287 天前
    @1016 #33 纳尼 ,客户端不也是前端吗,难不成是后端
    wanderingaround
        55
    wanderingaround  
       287 天前 via Android
    有真地猛士吗,不以对方好看不好看而采取不同做法,一视同仁。
    i571
        56
    i571  
       287 天前   ❤️ 1
    敢吐槽我小仙女?看我不让你社会性死亡,小红书,启动!!
    mouyase
        57
    mouyase  
       287 天前
    不看文档的啥都让人反感,哪怕买东西不看说明书的也一样让人反感。
    1016
        58
    1016  
       287 天前
    @cnoder #54 OP 说的是 ios
    LitterGopher
        59
    LitterGopher  
       287 天前   ❤️ 4
    姐妹们,谁懂啊。今天遇到一个后端,我就问了他几个问题他就生气了,真下头。
    Desiree
        60
    Desiree  
       287 天前   ❤️ 1
    建议去小红书发
    minglanyu
        61
    minglanyu  
       287 天前
    @7inFen 重新定义 number
    minglanyu
        62
    minglanyu  
       287 天前
    是不是文档写得不够详细?🤣
    Definezhang
        63
    Definezhang  
       287 天前
    文档乱写的后端我也挺讨厌的
    brader
        64
    brader  
    OP
       287 天前
    @minglanyu 421 错误码列表里的描述就那么几个字,还看不懂我觉得可以回去种田了
    PiersSoCool
        65
    PiersSoCool  
       287 天前
    这个时候能用 chatgpt 读文档的角色机器人就很适合了,这就是机会,兄弟们
    wuxingli
        66
    wuxingli  
       287 天前
    啊,我一个测试都看的懂唉,这文档已经写的很详细了
    adoal
        67
    adoal  
       287 天前
    不不不,以大半程序员的尿性,不论前端还是后端的,让他们自己看着文档去搞签名是铁定搞不出来的……得你先用他们用的语言封好调用的代码,甚至某些程序员你写了 example 里面用模拟参数示意都不行,一定要用真实环境的参数给他写好让他粘贴进去才能用。
    brader
        68
    brader  
    OP
       287 天前
    @adoal 我已经体会过这前端真的很水了,之前有个阿里还是百度的接口,公司说让前端直接接,她居然说实现那个接口签名验证需要 5 天。后来她们到接口调试有问题搞不定,让我帮忙看看,我就用服务端语言接了接口试没问题的,那个接口签名算法接入我也只用了 10 来分钟
    flyqie
        69
    flyqie  
       287 天前 via Android
    @1016 #58

    前后端定义确实不太明确。

    把 app 看做前端也不是不能理解,因为对用户来看他确实是前端,而且客户端确实存在与 web 前端一样的问题(不可信)
    xz410236056
        70
    xz410236056  
       287 天前
    现在还用 OC 的 iOS 开发都该枪毙
    @1016 #33 现在都叫大前端了
    topqrh
        71
    topqrh  
       287 天前 via Android
    不懂就问的也就算了,看心情回。最烦的就是不懂的事情来问解决方法,给出方法对方还要显得比你更懂😂
    smallthing
        72
    smallthing  
       287 天前 via iPhone
    @7inFen nunber 不是 string 是什么
    smallthing
        73
    smallthing  
       287 天前 via iPhone
    @flyqie app 本来就是前端,因为其主要负责呈现,和可不可信关系不大
    From313
        74
    From313  
       287 天前
    我们后端是不把文档写明白,我得一个个问。。烦死了
    exploreexe
        75
    exploreexe  
       287 天前
    还不是你惯的 一次两次就算了,三番五次的 你惯着他干嘛
    把文档写清楚,下次再问 让他自己去看文档就好了
    samyucn
        76
    samyucn  
       287 天前 via iPhone
    桌面的文档窗口开的太多了,我不想再多开一个
    v2hh
        77
    v2hh  
       287 天前
    只有我看出来两位女同志是想找 op 聊天才故意不看文档的吗😄
    JustBecause
        78
    JustBecause  
       287 天前   ❤️ 1
    这也能龟?直接让她看文档不就结了,女性开发有什么好特殊的,换成男性开发你还会这样忍者?
    beijinglowb
        79
    beijinglowb  
       287 天前 via iPhone
    @brader 这还不好,大家一块磨洋工呗,反正怪罪下来也是她们自己的锅。
    justin2018
        80
    justin2018  
       286 天前
    女同事 颜值不高~~~ -_-||

    ---------------------------

    话说 也讨厌那种不看文档的 你好歹说下 我看了文档 xx 分钟 但是还是没有解决 能否帮我看看这是啥问题

    最讨厌那种 直接发代码的 ~~
    justBugCoder
        81
    justBugCoder  
       286 天前
    这是客户端🐶
    qq2511296
        82
    qq2511296  
       286 天前
    @brader 贵司这种 iOS 实在是太水了,建议开除换人吧
    maguazhou
        83
    maguazhou  
       286 天前
    她们希望你直接帮她们写,出事了,还要你背锅和完善
    Pipecraft
        84
    Pipecraft  
       286 天前   ❤️ 3
    开发服务器的 API 返回错误码的同时,返回文档链接。
    {
    "code": 421,
    "msg": "错误原因请看 https://xxx ,有问题请提交 issue 。"
    }
    KrisWuSkrSkr
        85
    KrisWuSkrSkr  
       286 天前
    不满表达给这两个同事了吗?有不满你得表达出来让他俩知道啊,不然他们怎么改,说不定他们还以为你挺乐意解答这些问题的。
    brader
        86
    brader  
    OP
       286 天前
    @wuvvu
    @luomao
    @estk
    @8355
    @fantathat
    @Mithril
    @LitterGopher
    @qq2511296 看我附言。。。我不知道说什么好了
    zackd1e
        87
    zackd1e  
       286 天前
    这个附言就有点搞心态了哈哈
    lscexpress
        88
    lscexpress  
       286 天前
    只要不看文档的都是垃圾,我是针对任何人。
    lucybenz
        89
    lucybenz  
       286 天前
    泡她
    RexCarryu
        90
    RexCarryu  
       286 天前
    作为前端喜欢这种文档,省去很多沟通成本。我是大部分时候没文档可看
    7inFen
        91
    7inFen  
       286 天前
    小仙女是这样的,以自我为中心,周围人得围着她转
    binge921
        92
    binge921  
       286 天前
    先给她讲解一两天 获取好感 然后泡她 得到她 最后放手她 让她感受 暴怒的程序员是多么残忍
    star7th
        93
    star7th  
       286 天前
    这个文档,看起来是用开源版 showdoc 搭建的

    https://github.com/star7th/showdoc

    不过感觉是旧版。可以升级下到新版。
    zihuyishi
        94
    zihuyishi  
       286 天前
    这还是分工有问题,下次把客户端调用接口的工作分给后端就没有这么多问题了。而且自己写接口自己调用,避免了很多撕逼。把调用后端接口的工作交给客户端本身就不是那么合理,后端自己封装好客户端的 sdk 用起来也方便,更新维护也减少了很多交流的步骤
    fantathat
        95
    fantathat  
       286 天前 via iPhone
    也许只是单纯找你聊天,假装自己在工作
    Mithril
        96
    Mithril  
       286 天前
    @brader 你跟她说清楚啊,这是在浪费你的时间。
    有的人就是这样,总觉得别人的时间都是不要钱,可以随便打断进度,只要他有问题就必须立刻响应。
    你说清楚一次,以后同类问题就都不回了。
    Satella
        97
    Satella  
       286 天前
    直男,一看就是喜欢你啦
    cBlank
        98
    cBlank  
       286 天前
    直接说,文档上有,你不好好看不就是浪费我们俩的时间么?
    tonytonychopper
        99
    tonytonychopper  
       286 天前
    你的同事这样是怎么被招进去的,令人深思🤔️
    estk
        100
    estk  
       286 天前
    “我知道百度可以解决问题,但是问你更快呀”
    1  2  
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2995 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 39ms · UTC 00:38 · PVG 08:38 · LAX 17:38 · JFK 20:38
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.