コメントと例の翻訳

[ghost]

他の初心者が答えを役に立つと思うので、ここでこの質問をするだろうと思いました。ドキュメントを翻訳する場合、コメントは翻訳する必要がありますか?

<!-- これはコメントです。 -->

HTML や TypeScript はどうですか?

<p>これはフォーマットされた <b>HTML</b> です</p>

私は「面倒な」ドキュメント (angular/angular-ja#692) に取り組んでおり、翻訳する必要があると判断されない限り、何かを翻訳したくありません。

[lacolaco]

サンプルコード中のコメントも翻訳されていると、学習者にとってはとても親切だと思います。しかしコミュニティでのボランティアの翻訳プロジェクトでもっとも重要なのはコントリビューターによって持続的にメンテナンスされることです。
なので、はじめから完全な翻訳を目指さず、コントリビューターのモチベーションを保てるレベルでよいと思います。もしコメントも翻訳されているべきだと思う人がいれば、その人自身が翻訳できるのがオープンソースですから。

[ghost]

ご回答ありがとうございます。