Utiliser le modèle de sujet par défaut pour les fonctionnalités et les bogues

Contribuer Commentaires sur le site
1

Bonjour,

Puisque j’ai appris ici que les catégories proposent déjà des modèles de sujets, je suggère d’en utiliser un pour les catégories Contribute > Feature et Contribute > Bug sur meta.discourse.org.

Je ne suis pas certain de connaître exactement le format à utiliser, alors j’ai simplement pris un modèle de ticket GitHub d’Icinga et je l’ai légèrement adapté pour Discourse.

Contexte

D’après mon expérience, il n’est pas toujours évident de comprendre de quel problème nous parlons exactement. Jouer au « ping-pong » pour découvrir l’environnement, les outils impliqués et les idées qui n’existent que dans la « tête » de l’utilisateur prend du temps et peut être épuisant.

Je pense qu’un modèle de sujet par défaut pourrait aider à rappeler aux utilisateurs quels détails sont importants, ou comment structurer leur « récit ».

J’aime généralement utiliser des chapitres et des titres lors de la description d’un problème. Cela permet à chacun de suivre et de repérer les détails pertinents. Le contexte et les informations supplémentaires sur les versions et les particularités du navigateur sont particulièrement utiles.

Un point compliqué avec ce modèle : on ne comprend pas toujours bien comment fonctionnent les commentaires HTML et pourquoi ils sont masqués dans la vue principale. Bien que j’aie vu beaucoup d’utilisateurs l’adopter tel quel sans le modifier.

Exemple

<!--- Provide a general summary of the issue in the Title above -->

<!-- Please make sure to read https://meta.discourse.org/t/how-to-request-new-features-for-discourse/32986?source_topic_id=11 first -->

## Expected Behavior
<!--- If you're describing a bug, tell us what should happen -->
<!--- If you're suggesting a change/improvement, tell us how it should work -->

## Current Behavior
<!--- If describing a bug, tell us what happens instead of the expected behavior -->
<!--- If suggesting a change/improvement, explain the difference from current behavior -->

## Possible Solution
<!--- Not obligatory, but suggest a fix/reason for the bug, -->
<!--- or ideas how to implement:  the addition or change -->

## Steps to Reproduce (for bugs)
<!--- Provide a link to a live example, or an unambiguous set of steps to -->
<!--- reproduce this bug. Include configuration, logs, etc. to reproduce, if relevant -->
1.
2.
3.
4.

## Context
<!--- How has this issue affected you? What are you trying to accomplish? -->
<!--- Providing context helps us come up with a solution that is most useful in the real world -->

## Your Environment
<!--- Include as many relevant details about the environment you experienced the problem in -->
* Version used (Admin - Dashboard):
* Enabled plugins (Admin - Plugins):
* Browser name and version:
* Developer tools errors:
2 « J'aime »
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 « J'aime »
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