Sommario
Questo argomento della documentazione copre come scrivere una richiesta di funzionalità in Discourse: Una guida passo passo.
Passo 1: Prima di iniziare
Hai una grande idea per una funzionalità di Discourse? Fantastico! Ecco come puoi condividerla efficacemente con il team e la community. Prima di inviare una richiesta di funzionalità, prenditi un momento per cercare nelle discussioni esistenti per vedere se la tua idea è già stata suggerita o implementata. Puoi farlo in un paio di modi:
- Cercando nella categoria Feature
- Cliccando sull’icona
nell’angolo in alto a destra della pagina per aprire la ricerca. Puoi usare filtri avanzati per filtrare per categoria e tag. - Sfogliare gli argomenti con il tag pr-welcome - Un PR è una pull request su GitHub - un modo per gli sviluppatori di introdurre nuovo codice in un progetto.
- Sfogliare gli argomenti con il tag completed
- Cercando nelle categorie Plugin e Theme component
Se il tuo suggerimento di funzionalità è già elencato, puoi supportarlo votando per renderlo più visibile, mettendo “mi piace” e rispondendo con idee aggiuntive o casi d’uso, per comunicare ulteriormente la sua utilità e perché la funzionalità dovrebbe essere aggiunta.
Non riesci a trovare alcuna menzione della tua idea? Puoi creare una richiesta di funzionalità.
Passo 2: Le basi
Titolo
È importante che i titoli degli argomenti siano informativi, ma allo stesso tempo non troppo lunghi. L’ambito della richiesta dovrebbe essere facilmente identificabile a colpo d’occhio.
Categoria
Quando crei un nuovo argomento, seleziona la categoria Feature.
Tag
I tag vengono utilizzati per raggruppare e classificare le funzionalità, quindi, per mantenere organizzate le richieste, taggare il tuo argomento in modo appropriato è molto utile ai fini del tracciamento. Ad esempio, tutto ciò che è relativo al plugin chat viene raggruppato sotto un unico tag.
Passo 3: Scrivere la tua richiesta
Scrivere una buona richiesta di funzionalità è importante, aiuta il team di Discourse a identificare rapidamente le aree che potrebbero necessitare di miglioramenti.
Ricorda, quando crei una richiesta di funzionalità, stai cercando di proporre la tua idea e convincere le persone che la tua idea per una funzionalità è ben fondata. Spiega perché vuoi che la tua funzionalità venga aggiunta: alla community, a te stesso e al Team.
Nel corpo del tuo argomento, dichiara concisamente la funzionalità che stai richiedendo. Sii specifico e descrittivo, evita di essere vago o aperto.
Fornire contesto e spiegazione
Fornisci contesto e spiegazione per la tua richiesta di funzionalità.
- Una descrizione chiara della funzionalità che stai richiedendo
- Includi il problema o i casi d’uso della tua attuale difficoltà e come la tua funzionalità lo risolverebbe
- Qualsiasi informazione di base o ricerca pertinente che hai fatto
Fornire esempi e screenshot (Opzionale)
Se applicabile, fornisci esempi, mockup o screenshot per aiutare a illustrare la tua richiesta di funzionalità in modo che gli altri possano visualizzare facilmente la tua idea.
Interagisci con la Community
Una volta creata la tua richiesta di funzionalità, interagisci con i membri rispondendo a domande e feedback. Questo aumenterà le possibilità che la tua richiesta venga presa in considerazione.
Cosa aspettarsi dopo
Dopo aver inviato la tua richiesta di funzionalità, verrà esaminata dalla community e dal Team di Discourse. Puoi aspettarti:
- Feedback e discussione dalla community
- Una risposta dallo staff di Discourse che indica se la tua richiesta è fattibile e in fase di considerazione
- Potenziale implementazione della tua richiesta di funzionalità in un aggiornamento futuro
Vuoi assicurarti che la tua funzionalità venga realizzata?
In alcuni casi, le richieste di funzionalità potrebbero non essere adatte al core. Puoi leggere come vengono prese le decisioni sulle funzionalità. Se non sei in grado di sviluppare la funzionalità tu stesso, ci sono ancora modi per aumentare le possibilità che venga realizzata.
Diventa un cliente di discourse.org
Se desideri finanziare lo sviluppo ospitando siti con noi – diamo sempre priorità alle richieste dei clienti nella nostra timeline di sviluppo – questo è un modo per ottenerla più velocemente. I clienti Enterprise possono richiedere funzionalità personalizzate (di solito sotto forma di plugin) al team core a una tariffa oraria.
Sponsorizza un’attività “pr-welcome”
Abbiamo un elenco completo di argomenti pr-welcome. Questi sono compiti che ci piacerebbe vedere completati, ma per i quali attualmente non abbiamo la larghezza di banda per lavorare noi stessi. Sponsorizzare qualcuno per lavorare su questi compiti è un ottimo modo per essere coinvolti e qualsiasi contributo a Discourse è molto apprezzato.
Offri lavoro a pagamento sul Marketplace
Se hai bisogno di un plugin fondamentale per la tua attività, pubblicizza un incarico a pagamento nella categoria Marketplace. Fornisci quanti più dettagli possibile, inclusi screenshot e budget. Potresti anche trovare liberi professionisti che offrono microservizi standardizzati come “installazione una tantum” o “tema personalizzato”.
Generale
Cose da fare e da non fare generali
Da fare
- Mantieni la tua richiesta concisa e focalizzata su un’unica funzionalità
- Evita di fare supposizioni sull’implementazione o sui dettagli tecnici
- Mostra volontà di scendere a compromessi e adattare la tua idea in base al feedback della community
Da non fare
- Includere più di una funzionalità per argomento
- Lasciare gli altri in dubbio sull’ambito della tua richiesta
FAQ
D: Cosa succede se non ho tempo per creare una richiesta di funzionalità dettagliata?
R: Se al momento non sei in grado di creare una richiesta dettagliata, rifletti su ciò che vuoi dire e riprova più tardi. Questo assicura che tu presenti la tua migliore argomentazione, con una maggiore probabilità che gli altri supportino la tua richiesta e che venga aggiunta.
D: Dove dovrei pubblicare la mia richiesta di funzionalità?
R: Usa la categoria appropriata - le richieste di funzionalità dovrebbero andare nella categoria Feature.
D: Cosa succede se non sono sicuro di quale tag usare per la mia richiesta?
R: Sebbene i tag corrispondano ai nomi dei plugin e dei componenti tema per facilità d’uso, un membro del Team o un Regular aggiungerà un tag appropriato al tuo argomento se viene lasciato vuoto.
Sii rispettoso e aperto nella tua richiesta. Evita di usare la richiesta di funzionalità per esprimere frustrazione. Qualsiasi linguaggio o comportamento inappropriato può comportare il ritardo o l’ignoranza della tua richiesta.
Risorse aggiuntive
- Categorie: Feature, Marketplace, Plugin, Plugin > Extras, Theme, Theme component
- Tag: current-projects, release-notes, pr-welcome, planned
- https://meta.stackexchange.com/questions/258136/how-do-i-write-a-good-feature-request
- How do we decide what goes into each release of Discourse?
- Discourse pricing | Discourse - Civilized Discussion
