共 15 句 · 中英对照 · 对应本级 10 个目标词
开始练这一级 →The upgrade caused a regression in our report service, so we opened the changelog together.升级让报表服务出现了一个「回归缺陷」，于是我们一起打开了「更新日志」。 Our teammate had already marked the broken points there.有位同事已经在那里标出了出问题的点。 The changelog said the old API was deprecated.更新日志说旧的接口已经「废弃」了。
So we opened the migration guide next.于是我们接着打开了「迁移指南」。 The migration guide is long but clear.迁移指南很长，但是很清楚。 It shows examples that explain each breaking change.它用示例解释每一处破坏性变更。 For example, one relative clause in the sample was rewritten into two short sentences.例如，示例里的一个「关系从句」被改写成了两个短句。 We followed it step by step and fixed the service.我们照着它一步步做，把服务修好了。
Near the end, we turned on verbose mode to see more logs.快结束时，我们打开了「详细模式」来查看更多日志。 We also applied a footnote at the bottom of our note.我们还在笔记底部加了一条「脚注」。
Do not use passive voice in the summary, because it hides who did what.摘要里不要用「被动语态」，因为它会隐藏是谁做的。 A migration guide helps users more when each step is written as a gerund.当每一步都用「动名词」来写时，迁移指南对用户的帮助更大。 Keeping the docs simple saves everyone time.把文档写简单，能为大家省下时间。 The deprecation was written in the guide, so nobody was surprised.因为「弃用」说明写在了指南里，所以没有人感到意外。 A participle is often shorter, but it can hide the subject.「分词」通常更短，但它可能把主语藏起来。
数据来源：NGSL（CC BY-SA 4.0）· ECDICT（MIT License）。短文为本项目为练习编写的配套材料。