Usa il template predefinito per funzionalità e bug

Contribuisci Feedback sul sito
1

Ciao,

visto che ho letto qui che le categorie forniscono già dei modelli di argomento, vorrei suggerire di utilizzarli per le categorie Contribute > Feature e Contribute > Bug qui su meta.discourse.org.

Non sono completamente sicuro del formato, quindi ho preso un modello di issue da GitHub di Icinga e l’ho modificato un po’ per Discourse.

Contesto

Dalla mia esperienza, non è sempre chiaro quale problema stiamo effettivamente discutendo. Giocare a “ping pong” per capire l’ambiente, gli eventuali strumenti coinvolti e le idee che esistono solo nella “testa” dell’utente è dispendioso in termini di tempo e a volte logorante.

Potrei immaginare che un modello di argomento predefinito di questo tipo possa essere d’aiuto, per ricordare agli utenti quali dettagli sono importanti o come formattare generalmente la propria “storia”.

In generale, preferisco l’uso di capitoli e intestazioni quando si descrive un problema. Questo permette a tutti di seguire il ragionamento e selezionare i dettagli rilevanti. Soprattutto il contesto e le informazioni aggiuntive sulle versioni e sulle specifiche del browser sono di grande aiuto.

Un aspetto complicato con il modello è che a volte non si capisce come funzionino i commenti HTML e perché siano nascosti nella visualizzazione principale. Anche se ho visto molti utenti semplicemente adottarlo e lasciarlo così com’è.

Esempio

<!--- Fornisci un riepilogo generale del problema nel titolo qui sopra -->

<!-- Assicurati di leggere https://meta.discourse.org/t/how-to-request-new-features-for-discourse/32986?source_topic_id=11 prima -->

## Comportamento atteso
<!--- Se stai descrivendo un bug, dirci cosa dovrebbe succedere -->
<!--- Se stai suggerendo una modifica/miglioramento, dirci come dovrebbe funzionare -->

## Comportamento attuale
<!--- Se descrivi un bug, dirci cosa succede invece del comportamento atteso -->
<!--- Se suggerisci una modifica/miglioramento, spiega la differenza rispetto al comportamento attuale -->

## Possibile soluzione
<!--- Non obbligatorio, ma suggerisci una correzione/motivo per il bug, -->
<!--- o idee su come implementare: l'aggiunta o la modifica -->

## Passaggi per riprodurre (per i bug)
<!--- Fornisci un link a un esempio live, o una serie di passaggi non ambigui per -->
<!--- riprodurre questo bug. Includi configurazione, log, ecc. per riprodurre, se rilevante -->
1.
2.
3.
4.

## Contesto
<!--- In che modo questo problema ti ha influenzato? Cosa stai cercando di ottenere? -->
<!--- Fornire il contesto ci aiuta a trovare una soluzione che sia più utile nel mondo reale -->

## Il tuo ambiente
<!--- Includi quanti più dettagli rilevanti possibili sull'ambiente in cui hai riscontrato il problema -->
* Versione utilizzata (Admin - Dashboard):
* Plugin abilitati (Admin - Plugins):
* Nome e versione del browser:
* Errori degli strumenti per sviluppatori:
2 Mi Piace
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 Mi Piace
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