Conversation
Sunbreak
force-pushed
the
master
branch
3 times, most recently
from
41044dd to
83a6373
Compare
SevenOutman
left a comment
SevenOutman
left a comment
There was a problem hiding this comment.
@Sunbreak Thanks for this translation, here are some changes I think the translation needs to apply before it's ready to be approved.
/cc @kettanaito I guess you may need reviews for this translation from a Chinese speaker so here it is.
|
|
||
| 为事物命名是很困难的。这张表试图让它变得更容易。 | ||
|
|
||
| 虽然这些建议可以适用于任何编程语言，但我将用JavaScript来说明它们的实际情况。 |
There was a problem hiding this comment.
在中英文混用时添加一个空格来分隔
将用 JavaScript 来说明
| ## 命名惯例 | ||
|
|
||
| 选择**一个**命名惯例并遵循它。它可以是 `camelCase`，`PascalCase`，`snake_case`，或其他任何东西，只要它保持一致。许多编程语言在命名规则方面有自己的传统；查看你的语言的文档或研究Github上一些流行的存储库 |
There was a problem hiding this comment.
Convention 建议翻译成“约定”，就像我们常说的 conventional commit 被翻译为“约定式提交”一样
|
|
||
| 一个名字必须是 _简短的_ ，_直观的_ 和 _描述性的_ 。 | ||
|
|
||
| - **短**。一个名字必须不需要花很长时间来输入，因此，要记住。 |
There was a problem hiding this comment.
开头的“短”改为“简短”，与上面划出的“简短的”一词对应
| 一个名字必须是 _简短的_ ，_直观的_ 和 _描述性的_ 。 | ||
|
|
||
| - **短**。一个名字必须不需要花很长时间来输入，因此，要记住。 | ||
| - **直观**。名字必须读起来自然，尽可能地接近普通话。 |
There was a problem hiding this comment.
这里的“普通话”可能会产生歧义，建议改为“常用说法”
| const a = 5 // "a" could mean anything | ||
| const isPaginatable = a > 10 // "Paginatable" sounds extremely unnatural | ||
| const shouldPaginatize = a > 10 // Made up verbs are so much fun! |
There was a problem hiding this comment.
这里的几条对不好的命名进行解释的注释也可以翻一下
| prefix? + action (A) + high context (HC) + low context? (LC) | ||
| ``` | ||
|
|
||
| 看看这个模式如何在下面的表格中应用。 |
There was a problem hiding this comment.
应该是“从下面的表格中看看这个模式如何应用”
|
|
||
| 看看这个模式如何在下面的表格中应用。 | ||
|
|
||
| | 名称 | 前缀 | 动作(A) | 高背景(HC) | 低背景(LC) | |
There was a problem hiding this comment.
HC/LC 建议翻译为“高层上下文”、“低层上下文”
| } | ||
| ``` | ||
|
|
||
| > 参见[compose](#compose)。 |
|
|
||
| ### `delete` | ||
|
|
||
| 将某样东西从存在的领域中彻底删除。 |
There was a problem hiding this comment.
Erase 建议翻译为“抹除”，与 delete 区分。
“从存在的领域”有点怪，我觉得讲“将某样东西的存在彻底抹除”即可。
|
|
||
| 将某样东西从存在的领域中彻底删除。 | ||
|
|
||
| 想象一下，你是一个内容编辑，有那个臭名昭著的帖子你想摆脱它。一旦你点击了一个闪亮的 "删除帖子"按钮，CMS就会执行`deletePost`动作，**不是**`removePost`。 |
2 participants
No description provided.