HN 写作课

工程师们二十年里聊过的写作。

工程师、作家、编辑和创业者在 Hacker News 上聊了二十年“怎么写”:怎么写得清楚、怎么讲好一个故事、技术文档怎么写、小说和出版是怎么回事。这里把其中关于写作与讲故事的帖子挑出来,配上中文导读、可以直接用的写作要点和评论翻译。

从必读开始
  • 2,600+篇关于写作的 HN 讨论

Writing tips

写作锦囊

正在抽一条写作要点…

Essential

必读 30 篇

在讨论库里看全部精选

编辑精选里 HN 讨论最热的 30 篇,每篇都有中文导读和写作要点。

  1. 正在载入…

Archive

讨论库

按发帖年份分布,点柱子筛选。

排序

    About

    这些讨论是怎么挑出来的

    1. 01

      从全量里捞

      读取 Hacker News 自 2006 年以来的全部帖子,用关键词先捞出 40 分以上、可能和写作有关的约 1.1 万篇。

    2. 02

      只留真正讲写作的

      由 AI 逐条判断是否和写作、讲故事、文风、出版有实质关系,剔除“写代码”“编辑器”这类字面撞车,并分进十个类别。

    3. 03

      提炼可用的要点

      为值得读的帖子写中文导读,提炼 2-4 条可以直接用到自己写作里的要点,并精选翻译 HN 高赞评论。内容由 AI 生成,可能有误。

    写作方法2018blakewatson.com

    用 Talon 以语音写作和编程

    Writing and coding by voice with Talon

    阅读原文 HN 讨论
    98HN 得分
    28条评论
    4条写作要点

    导读

    这篇介绍用 Talon 通过语音写作和写代码,并讨论语音交互如何改变命令记忆、可发现性与工具切换。对写作者来说,它不只是效率工具,也提醒我们:命令命名和界面结构会直接影响写作与编程流程的顺畅程度。

    关键词 语音写作语音编程命令设计人机交互

    可以直接用的写作要点

    1. 01

      用自然语言动词短语命名命令(如“rename variable”),比记“command-alt-r”这类任意快捷键更易记。

    2. 02

      尽量让同一套语音命令跨编辑器通用,降低尝试新工具的摩擦。

    3. 03

      把应用看作一组可调用的动作/API,优先使用命令面板或自动补全来发现和触发操作。

    4. 04

      选择语音编程工具时留意其开源状态、平台支持和维护活跃度,避免投入废弃项目。

    HN 评论精选

    语音命令用自然语言命名更易记且可跨应用复用,应用应暴露清晰的动作接口。

    过去几年我几乎全靠 Talon(以及此前的 VoiceCode)操作电脑;Talon+Dragon 是目前顶尖且进步很快的方案。语音控制改变了我对界面的理解。与键鼠相比,语音在任一时刻可调用的命令多得多:鼠标要为命令牺牲屏幕空间,快捷键要记往往随意的组合。语音仍有可发现性和记忆问题,但“rename variable”比“command-alt-r / command-shift-r”好记,而且可跨编辑器复用,降低换编辑器的摩擦。我还把应用看作一组(常定义不佳的)API,输入是键鼠事件;希望应用更清晰地暴露动作,命令面板/自动补全虽笨拙但可用(Atom、Jupyter 有),更直接的方式会更好。

    dwiel查看英文原文

    I use talon (and previously voicecode) for nearly all interactions with my computer for the past few years. Talon+dragon is definitely the state of the art and is quickly improving. Controlling the computer by voice has completely changed my understanding of user interfaces. One difference between voice vs keyboard/mouse is that the number of 'commands' that can be in scope at any moment is much much larger. With a mouse you must sacrafice screen space for each command, for keyboard shortcuts the user must memorize often somewhat arbitrary key combinations for every new app/command. With voice, there are still descoverability and some memorization issues, but they feel a lot different. I can remember the command "rename variable" much more easily than "command-alt-r", or was it "command-shift-r"? These commands can also be common across editors, reducing the friction of trying different editors. One other observation is how I now think of apps more as (often poorly defined) sets of APIs whose inputs are keyboard/mouse events. I really wish more apps had a cleaner method of exposing this API. Some apps have a command pallet or something similar where a keyboard shortcut brings up a auto completed list of all possible actions available, which is still clumsy, but workable. Atom and jupyter notebooks both have this. Something more direct would be very nice.

    语音编程领域多失败项目,Talon 的眼动追踪等新交互值得关注;可参考领域综述寻找替代方案。

    Talon 看起来非常有前景,尤其是通过眼动追踪实现的缩放鼠标。总体而言,语音编程领域是一片废弃项目的墓地。我去年写过一篇领域概览,感兴趣可看替代方案。

    geewee查看英文原文

    Talon is looking extremely promising, with its zoom mouse that works via gaze-tracking. Generally coding by voice is a graveyard of abandoned projects. I wrote an overview of the field last year, if anyone's interested in alternatives: https://medium.com/bambuu/state-of-voice-coding-2017-3d2ff41c5015

    工具选型要留意开源与平台支持,Caster、Dragonfly、Aenea 是可考虑的替代组合。

    Talon 有前景,但核心并非开源,而且 Nuance 已放弃 Dragon Naturally Speaking 在 OSX 上的支持。Caster 项目看起来仍更新,Dragonfly 也是,还有一个积极整合其他语音识别引擎的新分支。配合 Aenea,我可以在 Linux 上口述代码。

    CodeXs查看英文原文

    Talon is promising but is not open source at its core nor does Nuance has drop support for Dragon Naturally Speaking on OSX. Caster project seems up-to-date and Dragonfly as well with a new fork that's actively integrating other speech recognition engines. Combined with Aenea I can dictate code on Linux

    同类还值得读

    1. 被低估的工程技能:把文章写好

      Undervalued Engineering Skills: Writing Well

      这篇文章讨论为什么“写得好”是被低估的工程能力,以及它如何在团队协作、系统设计和职业发展中持续带来回报。

      写作方法2019 · 1,109 分 · 371 评4 条写作要点编辑精选
    2. 每行只写一句话:让写作和修改都更轻松的排版法

      Writing one sentence per line

      这是 Derek Sivers 的一篇短文,主张写作时每行只放一个句子,而不是按段落排版。

      写作方法2022 · 849 分 · 297 评4 条写作要点编辑精选
    3. 书面沟通是远程工作的超级能力

      Written communication is remote work super power

      这篇文章讨论远程工作中书面沟通的价值,评论区则补充了异步与同步沟通的适用场景,并提醒读者:备忘录、结论先行、结构化命令格式等书面沟通传统早已有之。

      写作方法2020 · 831 分 · 190 评4 条写作要点编辑精选
    4. 如何写出有用的文字

      How to Write Usefully

      保罗·格雷厄姆在这篇文章里给"有用的写作"下了一个可操作的公式:有用≈重要×新颖×正确×清楚,任一项为零,整篇文章就等于零;他还主张敢下确定判断、删掉让自己心虚的句子。

      写作方法2020 · 821 分 · 285 评4 条写作要点编辑精选
    5. 如何写得更清楚、想得更清楚,并学会复杂材料(PDF)

      How to write more clearly, think more clearly, and learn complex material [pdf]

      这份 PDF 讨论如何把文章写清楚、把思路理清楚,并用写作来学习复杂材料。

      写作方法2022 · 779 分 · 153 评4 条写作要点编辑精选

    打赏支持

    打赏二维码

    觉得有用,请作者喝杯咖啡。

    WeChat

    关注向阳乔木

    微信公众号「向阳乔木推荐看」

    微信公众号「向阳乔木推荐看」二维码

    微信扫一扫;在微信里打开本页时,长按二维码识别。