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

如何才算一篇好的技术文章

  •  
  •   xiaofan2 · 2020-09-10 11:42:28 +08:00 · 1628 次点击
    这是一个创建于 1296 天前的主题,其中的信息可能已经有所发展或是发生改变。

    如题,最近突然想写一些技术文章,想问问各位你们眼中的好的技术文章是什么样子的? 技术方向是 Java 以及数据库 中间件相关

    23 条回复    2020-09-11 00:12:21 +08:00
    murmur
        1
    murmur  
       2020-09-10 11:44:18 +08:00   ❤️ 1
    少吹牛逼多说坑,现在很多文章就是对着新技术一顿爆吹,他遇到什么问题,怎么解决的,一点也不说
    pushback
        2
    pushback  
       2020-09-10 11:47:30 +08:00
    先排除 CV (重点批评某平台恰烂钱文章)
    dilu
        3
    dilu  
       2020-09-10 11:53:01 +08:00   ❤️ 1
    1 、xxx 是什么
    2 、xxx 的优点 缺点 解决了什么问题
    3 、xxx 的底层原理 或者源码实现分析
    4 、xxx 的横向扩展技术 yyy 是什么 两者区别
    5 、xxx 的总结、历史回顾、社区评价
    6 、下期技术 bbb 预告
    murmur
        4
    murmur  
       2020-09-10 11:54:29 +08:00   ❤️ 1
    现在的文章是,太细的往往涉及别人竞争力,人家不愿意跟你分享,那么能分享的应该是

    1 、我用了 xxx 框架

    2 、我用在 xxx 业务,运行时间 xxx 月,用户量或者并发 xxxx (拿来学习的真的不配吹,你自己都不敢上生产你怎么忽悠别人用)

    3 、我投入了大概 xxx 人,对框架进行 xxx 级别的爆改 /调优 /监控

    4 、我遇到了 xxx 问题,这个问题导致我用了 xxx 时间 /人力解决(可以不说怎么解决,但是一定要暴露严重性)
    tikazyq
        5
    tikazyq  
       2020-09-10 12:01:42 +08:00   ❤️ 1
    注意别在文章或标题中加以下关键字:
    1. 面试
    2. 涨薪
    3. 万字
    4. 吐血推荐
    5. 初学者
    6. 入门
    7. 手撕
    8. 必备
    9. 详解
    10. 如何
    locoz
        6
    locoz  
       2020-09-10 12:02:18 +08:00 via Android
    深入浅出,循序渐进,有实际场景作为例子。

    很多人写技术文章是:“我碰到了一头大象,我要把大象塞进冰箱里,然后我这样这样再这样,大象就被塞进冰箱里了”。
    但读者看的时候就会很懵逼,你说你“这样这样再这样”,但不说具体怎么样,我怎么知道是怎么样的?
    CODEWEA
        7
    CODEWEA  
       2020-09-10 12:03:33 +08:00
    和营销号反着来
    Cbdy
        8
    Cbdy  
       2020-09-10 12:04:45 +08:00 via Android
    提供可以跑起来的实验代码 /demo
    Leigg
        9
    Leigg  
       2020-09-10 12:06:10 +08:00 via Android
    你的问题暴露了你平时看的都是不怎么样的技术文章。可以多去搜罗一些大牛的技术文章,
    fengjianxinghun
        10
    fengjianxinghun  
       2020-09-10 12:08:27 +08:00
    @murmur 还漏了一点,所有的数字 x10
    lecher
        11
    lecher  
       2020-09-10 12:12:59 +08:00   ❤️ 2
    draveness.me/whys-the-design/
    安利一个篇篇经典的 blog
    kop1989
        12
    kop1989  
       2020-09-10 13:13:57 +08:00
    我觉得怎么写一篇优秀的技术文章不好说。
    但是如何写一篇及格的技术文章我觉得还是有章可循的,而且只有一点,无非必要,勿增实体。
    我看很多技术文章,为了解释 A,引入一堆 BCDEF,结果还不解释 BCDEF 。
    coderluan
        13
    coderluan  
       2020-09-10 13:34:40 +08:00
    听说过一句话吗, "同样是裸体, 有的是色情有的是艺术, 而他们并没有什么量化标准, AI 也都分不清, 但是男人一看就知道是哪种.", 技术文章也是一样的.
    xiaofan2
        14
    xiaofan2  
    OP
       2020-09-10 13:47:55 +08:00
    @murmur 这个确实很重要
    @dilu 这个说实话很多 肯定不是一篇文章能搞定的

    @murmur 好方法

    @tikazyq 哈哈哈哈都懂套路

    @locoz 先场景再分析 再文后给代码怎样

    @Leigg 那请问你平时看的都有哪些大牛的
    Leigg
        15
    Leigg  
       2020-09-10 16:03:29 +08:00 via Android
    himself65
        16
    himself65  
       2020-09-10 16:03:50 +08:00 via iPad
    那就是真的在说技术……
    doveyoung
        17
    doveyoung  
       2020-09-10 16:04:14 +08:00
    如果一份文档不能复制粘贴,那就毫无意义
    perpetually
        18
    perpetually  
       2020-09-10 16:12:06 +08:00
    @murmur #1 在哪都能看到你,v 站轮子哥
    locoz
        19
    locoz  
       2020-09-10 16:13:35 +08:00
    @xiaofan2 #14 可以的。最好是在给代码的时候都一点一点来,说明白为什么要这么做,最后再放个完整代码到 GitHub 然后给个代码链接就行。
    asanelder
        20
    asanelder  
       2020-09-10 18:07:06 +08:00   ❤️ 1
    @lecher #11
    @Leigg #15 好东西

    技术文章俺不太懂,太高大上了。

    俺举一个写 leetcode 算法题解的例子吧。

    在俺看来,刚上的很多关于 leetcode 的讲解,就是用中文把代码复述了一遍。其实这种俺认为不是真正的教会别人怎么去解。

    好的文章应该是站在听者的角度,假设他什么也不知道,通过不断的引导与启发,来让他自己可以推导出来,最后他的感觉就是,是靠自己想出方案的。

    关于这方面的东西,有一本书可以推荐给楼主看看

    《怎样解题》(波利亚)

    "这是一本关于如何求解数学题的书,但里面的方法和思路可以应用在其它方面" --《代码大全》推荐语
    efcndi
        21
    efcndi  
       2020-09-11 00:05:41 +08:00
    @asanelder #20 哇哇哇!难得有人提到《怎样解题》啊!真的是一本了解数学的好书啊!
    asanelder
        22
    asanelder  
       2020-09-11 00:08:21 +08:00
    @efcndi #21 不过,没看过的还是别看,尤其初高中生。看完容易对应试环境不满。
    如果没有条件跳出应试环境的话,就像鲁迅所说的屋子里的人,醒来没出路很痛苦的。

    所以,对于大多数人来说,刷刷刷,是最好的方法
    efcndi
        23
    efcndi  
       2020-09-11 00:12:21 +08:00
    @asanelder #22 这可能是就是中国学生在国际数学竞赛上那么厉害,但最终没几个愿意搞数学的缘故。并非是真正的兴趣驱动,都是刷题出来的。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   5165 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 28ms · UTC 09:30 · PVG 17:30 · LAX 02:30 · JFK 05:30
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.