• 请不要在回答技术问题时复制粘贴 AI 生成的内容
brader
V2EX  ›  程序员

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

  •  1
     
  •   brader · Sep 5, 2023 · 13658 views
    This topic created in 1155 days ago, the information mentioned may be changed or developed.
    就一个接口签名机制,我已经详细的给出了签名步骤的文档,并辅助性的给出了服务端版的代码示例实现(抱歉我没有能力提供 objective-c 版本的),两位女同志 IOS ,第一次接入不细看文档,反反复复的问我忍了,接入过程中喜欢截图提供 objective-c 的代码报错好似让我给她 debug 一样我也忍了。
    这套签名机制上线以来,她们已经接入超过 3 个项目了,今天大早上还有个人来问我这样的问题,我真的不知道怎么吐槽好,我觉得这已经不属于技术范围的问题了,这是纯不看文档



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

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

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

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

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

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

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

    https://github.com/star7th/showdoc

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