语言与文风2013github.com
一个用于自然拼写与语法检查的 Ruby gem
A rubygem for natural spelling and grammar checking
导读
这个帖子介绍了一个 Ruby gem，它把 Ginger 的在线拼写/语法检查服务封装成库；讨论主要围绕标题是否名副其实、API 密钥和调用限制。对写作者来说，它提醒我们：校对工具可以帮忙，但要清楚它依赖外部服务，以及有哪些限制。
可以直接用的写作要点
- 01
标题要如实反映实现方式：只是封装外部 API 的工具，别写成“纯 Ruby 实现”，否则会误导读者。
- 02
依赖第三方校对服务前，先确认接口文档、速率限制和使用条款，别把别人的密钥硬编码进代码。
- 03
把校对工具做成实时反馈，比写完再逐句检查更容易发现问题。
- 04
自动化语法检查只能辅助，最终仍需自己通读，判断语气和逻辑是否合适。
HN 评论精选
标题措辞要准确，否则读者会误解作品的性质。
一个给网络服务 API 用的库？恭喜你做出来了，但标题让我以为这是一个纯 Ruby 实现的拼写和语法检查器。
neilk查看英文原文
A library for a web service API? Hey, congrats on doing creating it, but the headline made me think there was a spelling and grammar checker in pure Ruby.
用外部服务前要查清文档、密钥管理和使用条款。
我在 gingersoftware.com 上没看到这个 API 的文档。看起来它把发送到 services.gingersoftware.com 的 API key 硬编码了。@subosito：我猜你是这家公司的人？速率限制是多少？商用和非营利使用的条款是什么？
jschuur查看英文原文
I don't see the API documented on http://gingersoftware.com. It seems to hardcode the API key it sends to http://services.gingersoftware.com/Ginger/correct/json/GingerTheText @subosito: I take it you work for these guys? What's the rate limit? Commercial or non profit usage terms?
依赖第三方服务时要加测试验证，并各自申请密钥。
谢谢你写这个 gem，看起来非常棒。我希望 Ginger Proofreader 能一直保持 API 可用，不过我会在自己的应用里写些测试，确保它正常工作。我注意到你的 gem 里用了你自己的 API key，我不清楚他们的速率限制，但大家各自申请自己的 key，可能对所有人都有好处。
wesray查看英文原文
Thanks for writing this Gem, looks absolutely awesome. I hope Ginger Proofreader keeps their API up also, but I will definitely write some tests in my app to make sure it's working. I noticed in your gem you are using your API key, and I'm not sure about their rate limits, but it would probably be in everyones best interest to get their own key.
校对的价值在于实时反馈，可以想想怎么把它嵌入写作流程。
你打算在应用里怎么用它？会在客户端集成，实时给用户反馈吗？
jhonovich查看英文原文
How do you anticipate using this in your apps? Will you integrate it on the client side to provide real time feedback to users?
同类还值得读
像说话一样写作
Write like you talk
这篇短文主张写作应像说话一样自然、清晰，避免装腔作势的书面腔。
语言与文风2015 · 647 分 · 272 评4 条写作要点编辑精选法律语言难懂源于写作不佳，而非专业概念
Poor writing, not specialized concepts, drives difficulty with legal language
这是一项认知科学研究：法律文本难懂，主要不是因为充斥专业术语，而是因为写作者把句子写得又长又绕、修饰语层层嵌套、回指距离过远。
语言与文风2022 · 559 分 · 322 评5 条写作要点编辑精选写得简单
Write Simply
保罗·格拉汉姆在这篇短文里主张：好文章应该写得简单——用日常词汇、短句、直白的结构，不为显得聪明而堆砌复杂表达。
语言与文风2021 · 484 分 · 330 评4 条写作要点编辑精选Tortured phrases：科学写作中出现的一种可疑文风
Tortured phrases: A dubious writing style emerging in science
《自然》新闻报道了一种在科学论文中蔓延的怪现象：原本标准的术语被同义替换软件改写成了古怪说法，比如把 "cloud computing" 写成 "haze figuring"。
语言与文风2021 · 329 分 · 256 评4 条写作要点编辑精选乔治·奥威尔 1940 年对《我的奋斗》的书评
George Orwell's review of Mein Kampf (1940)
这是奥威尔1940年对《我的奋斗》的书评。
语言与文风2014 · 305 分 · 240 评4 条写作要点编辑精选