Re: [讨论] 注解 用中文还是英文

楼主: AmosYang (泛用人型编码器)   2018-03-20 07:22:28
※ 引述《x246libra (宸火)》之铭言:
: 本身英文不好
: 英转中还可以看懂
: 中转英常常想不到用什么词
: 勉强靠GOOGLE用些简单的单字
: 让变量或函数 为有意义的命名
: 但是注解通常要写的比较详细
: 用英文总是思考很久,也不确定文法是否正确
原题是讨论中英文之间的选择取舍,这里岔题分享一个资源:
微软 PowerShell 指令动词列表
Approved Verbs for Windows PowerShell Commands
https://msdn.microsoft.com/en-us/library/ms714428.aspx
“英文不好”是个很大的题目,相对于“听、读”,“说、写”的自学门槛较高。
以程式设计师来说,“写英文”的需求可分为至少两大方面:
* 命名
- “名词”: 变量(variable)、类别(class)
- “动词”: 函式(function) / 方法(method)
* 说明/描述
- 短文注解 (code/commit comment)
- 长篇文件(documentation) / 手册(manual)
这个“微软 PowerShell 指令动词列表”当然不是唯一的标准,但它列出了许多动
词 (尤其是程式设计领域常用的动词) 及其使用情景的说明,可以作为“动词命名
”的参考。
如果对这列表里的动词使用情景说明有疑问,欢迎提出讨论 :)
作者: Hexxer (KxT)   2018-03-20 08:26:00
推一个,有标准总是好的
作者: t64141 (榕树)   2018-03-20 10:36:00
好东西
作者: x246libra (楓)   2018-03-20 12:43:00
回家研究
作者: Y78 (Y78)   2018-03-20 13:37:00
原来有这种东西 推
作者: cutekid (可爱小孩子)   2018-03-20 14:29:00
推(Y)
作者: yyc1217 (somo)   2018-03-20 14:59:00
remove delete erase
作者: Ghamu (猫丸)   2018-03-20 23:07:00
赞~
作者: bakedgrass (蒙古烤小草)   2018-03-21 01:11:00
推,很有帮助
作者: s678131 (Mu)   2018-03-21 20:58:00
谢谢
作者: ntusaber   2018-03-23 00:36:00

Links booklink

Contact Us: admin [ a t ] ucptt.com