ローカライズされたドキュメントをネイティブで処理できるようになるまで、タイトルにフラグを付けるのが最も実用的な方法であり、このガイドラインの妥当な例外だと思います。
この種のことは、どちらの意見や好みも異なると思いますが、このスタイルガイドでは、業界で認められている標準を採用します。繰り返しになりますが、GoogleとMicrosoftのガイドラインは、一般的な短縮形を使用した方が良いという点で一致しています。
とはいえ、否定的な短縮形(「can’t」など)を使用すると、英語話者でない人にとって理解が難しくなる可能性があるという意見もいくつか読みました。この点についてはさらに調査し、必要に応じてスタイルガイドを更新します。
その例は削除しました! ![]()
はい、それは非常に一般的です(Discourseだけでなく)、しかし、それが正確ではないことには同意します。引用符を使用する方が良いでしょう。そのため、スタイルガイドで明示することにしました。
それは素晴らしい点です。スタイルガイドに追加します!
ドキュメントトピックの多くが私に割り当てられなくなったことは感謝していますが、チームのすべてのドキュメントトピックの作成者としてDiscourseを使用するのは、少し冷たく感じます。
このフィードバックありがとうございます! @maikiは上記でいくつかの良い点を挙げており、私はそこで彼が言っていることに同意します。それに加えて、公式ドキュメントの作成者を@Discourseにした理由の1つは、特に初めてドキュメントにアクセスする読者に対して、より権威があると感じてもらうためです。これも、そもそもスタイルガイド全体を作成した動機です。
ドキュメントを作成する人は、誰でも自分の個性を文章に注入できますし、個々のドキュメントトピックに関する議論はなくなるわけではないので、そこは常にパーソナルなものにする良い場所です。
これらのフィードバックはすべて非常に感謝しています ![]()