BugKotlinDocument icon indicating copy to clipboard operation
BugKotlinDocument copied to clipboard

🤔

Open EltonZhong opened this issue 6 years ago • 1 comments

Kotlin 没有生成注释的快捷键可能是有原因的, 这是by design Clean code 书里讲到:多余的注释不如没注释。 在Kotlin 的设计里, 对于

fun sum(a, b)

Get sum of [a] and [b] (或者没有注释) 是比下面的注释更直观的: /**

  • @param a
  • @param b
  • ... **/

EltonZhong avatar Dec 06 '18 09:12 EltonZhong

这完全是JB愿不愿意做的事……在IDE里面文档的 popup【对着函数名按 ctrl+Q (mac ctrl+J)】你可以看到他自己都不符合自己的规范,只能说明那些人的关注重心根本不在这里。要是真的不需要注释,JB干嘛还在语言里面专门讲文档注释怎么写。(property和 sample 能format出来算我输)

zxj5470 avatar Dec 07 '18 04:12 zxj5470