xiaofan2
V2EX  ›  问与答

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

  •  
  •   xiaofan2 · Sep 10, 2020 · 2244 views
    This topic created in 2095 days ago, the information mentioned may be changed or developed.

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

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

    1 、我用了 xxx 框架

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

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

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

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

    @murmur 好方法

    @tikazyq 哈哈哈哈都懂套路

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

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

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

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

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

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

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

    《怎样解题》(波利亚)

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

    所以,对于大多数人来说,刷刷刷,是最好的方法
    efcndi
        23
    efcndi  
       Sep 11, 2020
    @asanelder #22 这可能是就是中国学生在国际数学竞赛上那么厉害,但最终没几个愿意搞数学的缘故。并非是真正的兴趣驱动,都是刷题出来的。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   2703 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 59ms · UTC 15:34 · PVG 23:34 · LAX 08:34 · JFK 11:34
    ♥ Do have faith in what you're doing.