機能とバグにはデフォルトのトピックテンプレートを使用

こんにちは。

こちらのカテゴリがすでにトピックテンプレートを提供していることを学んだので、meta.discourse.org#contribute:feature#contribute:bug カテゴリでそれらを使用することをお勧めします。

フォーマットが完全に把握できているわけではありませんが、Icinga の GitHub イシューテンプレートを取ってきて、Discourse 向けに少し修正しました。

背景

私の経験では、実際にどの問題について話しているのかが必ずしも明確でないことがあります。「ピンポン」ゲームのように、環境、関与している可能性のあるツール、ユーザーの「頭の中」にしか存在しないアイデアなどを明らかにするためにやり取りするのは、時間がかかり、時には疲れを伴います。

このようなデフォルトのトピックテンプレートが、ユーザーにとってどの詳細が重要か、あるいはどのように「ストーリー」を一般的にフォーマットすべきかを思い起こさせる助けになるかもしれません。

問題を説明する際は、章見出しや見出しを使うのが一般的に好きです。これにより、誰もが追跡し、関連する詳細を選択することができます。特に、バージョンや特定のブラウザに関する洞察に関するコンテキストと追加情報は、非常に役立ちます。

テンプレートに関連して複雑な点の一つは、HTML コメントの動作方法や、なぜメインビューでそれらが非表示になるのかが必ずしも理解されていないことです。多くのユーザーがそれを受け入れて、そのままにしているのを見てきましたが。

<!--- 上記のタイトルに問題の一般的な要約を提供してください -->

<!-- https://meta.discourse.org/t/how-to-request-new-features-for-discourse/32986?source_topic_id=11 を最初に読むことを確認してください -->

## 期待される動作
<!--- バグを説明している場合は、期待される動作を教えてください -->
<!--- 変更/改善を提案している場合は、どのように機能すべきかを教えてください -->

## 現在の動作
<!--- バグを説明している場合は、期待される動作の代わりに何が起きているかを教えてください -->
<!--- 変更/改善を提案している場合は、現在の動作との違いを説明してください -->

## 解決策の可能性
<!--- 必須ではありませんが、バグの修正/理由を提案してください -->
<!--- または、追加または変更を実装する方法を提案してください -->

## 再現手順(バグの場合)
<!--- ライブ例へのリンク、またはこのバグを再現するための明確な手順のセットを提供してください -->
<!--- 関連する場合は、構成、ログなどを提供して再現してください -->
1.
2.
3.
4.

## 背景
<!--- この問題があなたにどのように影響しましたか?何を達成しようとしていますか? -->
<!--- 背景を提供すると、現実世界で最も役立つ解決策を提案するのに役立ちます -->

## 環境情報
<!--- 問題が発生した環境に関する関連する詳細をできるだけ多く含めてください -->
* 使用しているバージョン(管理 - ダッシュボード):
* 有効になっているプラグイン(管理 - プラグイン):
* ブラウザ名とバージョン:
* 開発者ツールのエラー:

「いいね!」 2

Topic templates aren’t particularly effective in my experience – they are certainly no magic bullet. The type of people you would want to read them, rarely do, and for those that know what they are doing, they get in the way.

I would only do this if there are certain very mandatory things you need in each topic, like serial number or something.

「いいね!」 3

Hi,

I get your point, the many who feel disturbed by such a template will just ctrl+a&del the content. I do that sometimes as well, when the structure doesn‘t fit.

I know too little about this community til now. From reading threads I‘d say you do not really need it, as this platform has a totally different conversation “flow” and is more a chat than issue discussions. I love to hear what others think, and won‘t be sad if you do not apply it :slight_smile:

Still, I hope such a template helps others who might have been looking into the same for their setup. It took me quite a while to find the perfect template for github, you likely have only one shot amongst established readers :wink:

Cheers,
Michael