Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

コメントを日本語か英語どちらにするかを決める #113

Open
tennashi opened this issue May 10, 2020 · 1 comment
Open

Comments

@tennashi
Copy link

#111 に関連して
いくつか日本語と英語のコメントが混じっているので // 犯人は私です、すいません

golint が求めるコメントの書き方...

  • 日本語だとそれに合わせるためのルールが必要で、それを強制するのが面倒
  • 英語だと自然に表現できる

参加者的には...

  • 日本語読み書きできる人がほとんど
  • 英語だと機械翻訳越しの会話になりかねず、下手すれば機械翻訳のライセンス表記をすることまで考えないといけない // 読みはともかく書きは...という人もいるのではという

ということで、私自身は日本語コメント寄りです // エラーメッセージとかは英語でいいと思います
// 英語のほうが小さいコメントとか書きやすいとかいうのはもちろんありますし、英語を日常的に使われてる方にはコストでしかないと思うので、意見募集です

まぁ統一さえされてれば何でもという方が多いかもしれませんが、一応 Issue に挙げておきます

@koron
Copy link
Member

koron commented May 11, 2020

わたしは go vet & golint さえ通るなら混在で良いと思います。

書きやすいほうで書いて、意味不明なレベルでわかんなかったら
詳しそうな人か書いた人に問い合わせて書き直す、書き足すみたいな運用ができたらなと。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants