V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
xiqingongzi
V2EX  ›  问与答

一个开发者产品下线怎么样才能足够优雅

  •  
  •   xiqingongzi · 2022-02-10 16:13:48 +08:00 · 1759 次点击
    这是一个创建于 1015 天前的主题,其中的信息可能已经有所发展或是发生改变。

    方向是面向开发者的产品,用户都是开发者。类似 LeanCloud

    8 条回复    2022-02-11 11:54:52 +08:00
    sadfQED2
        1
    sadfQED2  
       2022-02-10 17:19:19 +08:00 via Android
    http code 404 大家都懂
    xiqingongzi
        2
    xiqingongzi  
    OP
       2022-02-10 17:42:12 +08:00
    @sadfQED2 让我想起来了「相信乌云」
    adoal
        3
    adoal  
       2022-02-10 17:59:02 +08:00 via iPhone
    提前一段时间给用户通知即可。如果有后续替代产品,在文档和接口里标记 deprecated 。
    PerFectTime
        4
    PerFectTime  
       2022-02-10 18:20:21 +08:00
    看错,看成一个开发者产品线下怎么样才能足够优雅
    jybox
        5
    jybox  
       2022-02-10 18:25:40 +08:00   ❤️ 7
    对于开发者服务来说,每个 API 、每个参数都有大量的细节,和面向终端用户的产品很不一样。图形界面改了,用户自己会去适应,但调用 API 的程序不会自己适应,还是要开发者来改。

    对于类似 LeanCloud 这种提供了十多种不同语言 SDK 、上百个 API 接口、加一起可能有几千个参数的服务来说,其实「下线功能」这种事情是经常会发生的。

    对于客户端来说,能做的就是尽量遵守 Semantic Versioning (语义化版本号),把不兼容改动都放在 major (大版本)的更新里,甚至提前几个版本就开始打印警告,对于不兼容的改动提供详细的迁移文档(应该换成哪些 API 来替代);要及时在文档和 Demo 中将即将废弃的接口去掉,如果整个 Demo 都不再支持的话也要在 GitHub 上修改 README 后 archive 掉。

    对于服务端来说接口一旦下线就彻底无法使用,通常要更加慎重,比如需要在客户端去掉该接口比较长时间以后、从监控看到接口的使用量很小的情况下再下线;提前将功能的入口(如文档)去掉,避免新的开发者使用。

    确实有时候迫于业务方向或者法规要求,还是会有一些比较生硬的「下线」,但无论如何还是要将这个事情提前通知到开发者。如果只是一个小功能最好能精确通知到受影响的用户,通知的时候态度还是要坚决,要约定明确的下线时间,否则开发者不会当回事;如果是整个产品的下线则应该有公开的公告,最好是能由 CEO 或者高层负责人在其中介绍一下前因后果。

    对于涉及数据的应用要提供导出数据的方式和文档;涉及到费用的要为开发者退款,最好是在「从通知到下线」这个过渡期不再收取费用。

    说到服务下线有个有趣的做法是「提前下线一小段时间来起到通知的作用」然后再恢复给开发留出迁移的时间,GitHub 就曾经这么做过 https://developer.github.com/changes/2018-11-05-github-services-brownout
    DT27
        6
    DT27  
       2022-02-10 20:34:47 +08:00
    开源。
    leipengcheng
        7
    leipengcheng  
       2022-02-11 11:32:55 +08:00
    有点不舍得,我的所有服务都是一直开着的,哪怕用户不多
    jones2000
        8
    jones2000  
       2022-02-11 11:54:52 +08:00
    如果是白嫖的用户, 直接下线就可以。 如果是付费用户,电话或邮件提前 1 个月通知到。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   968 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 25ms · UTC 21:43 · PVG 05:43 · LAX 13:43 · JFK 16:43
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.