✨ Grazie per il contributo a dungeonworld-ita! ✨
Come contributore, qui trovi tutte le linee guida da seguire:
Aiutaci a mantenere dungeonworld-ita aperto e inclusivo. Ti prego di leggere e seguire il nostro Codice di condotta.
Come utente di dungeonworld-ita, sei il candidato ideale per aiutarci a migliorare la nostra documentazione: correzioni di errori di battitura, chiarificazioni, più esempi, nuovi documenti, ecc.
I problemi confermati e i materiali pronti per essere sviluppati sono marcati con la label help wanted. Posta un commento nella issue per indicare che vuoi lavorarci te o per richiedere aiuto ai maintainers o alla community.
Una buona segnalazione di errori non dovrebbe costringere gli altri a cercarti per ottenere ulteriori informazioni. Per favore, cerca di essere il più dettagliato possibile nella tua segnalazione.
Le richieste di materiali sono benvenute, ma prenditi un momento per capire se la tua idea si adatta allo scopo e agli obiettivi del progetto. Sta a te presentare un argomento convincente per convincere gli sviluppatori del progetto dei meriti di questa funzionalità. Fornisci il maggior numero possibile di dettagli e contesto.
Le buone pull request, che siano correzioni, miglioramenti o nuovi materiali, sono un aiuto fantastico. Dovrebbero rimanere focalizzate nell'ambito e evitare commit non correlati.
Per favore, chiedi prima di intraprendere qualsiasi pull request significativa (ad esempio, la riformattazione del layout di tutti i libretti), altrimenti rischi di passare molto tempo a lavorare su qualcosa che i manutentori del progetto potrebbero non voler unire al progetto.
Se non hai mai creato una pull request prima, benvenuto 🎉 😄. Ecco un ottimo tutorial su come inviarne una :)
Ecco un riassunto dei passaggi da seguire:
- Configura l'ambiente di lavoro con gli strumenti necessari per editare i files
- Se hai clonato il repository tempo fa, ottieni le ultime modifiche dall'origine e aggiorna le dipendenze:
$ git checkout master
$ git pull upstream master
- Crea un nuovo ramo tematico (dalla branch di sviluppo principale del progetto) per contenere la tua funzionalità, modifica o correzione:
$ git checkout -b <nome-branch-tematico>
- Apporta le modifiche al materiale, seguendo le Regole di codifica.
- Fai il push del tuo ramo tematico nel tuo fork:
$ git push origin <nome-branch-tematico>
- Apri una pull request con un titolo e una descrizione chiari.
Suggerimenti:
- Per lavori ambiziosi, apri una pull request il prima possibile con il prefisso
[WIP]
nel titolo, al fine di ottenere feedback e assistenza dalla comunità. - Consenti ai manutentori di dungeonworld-ita di apportare modifiche al tuo ramo. In questo modo, possiamo apportare alcune modifiche minori se necessario. Tutte le modifiche che apportiamo verranno effettuate in nuovi commit e chiederemo la tua approvazione prima di unirli.
- Evita di formattare a mano e usa gli stili carattere e gli stili paragrafo presenti nei files
- Modificatori di Caratteristica (FOR, DES, INT, SAG, CAR): Scrivere i nomi dei Modificatori di Caratteristica in MAIUSCOLO. Saranno formattati automaticamente con lo stile carattere
stat
quando utilizzati nei paragrafi. - GM: Scrivere GM in MAIUSCOLO. Sarà formattato automaticamente con lo stile carattere
strong
quando utilizzato nei paragrafi. - PF: Scrivere PF in MAIUSCOLO. Sarà formattato automaticamente con lo stile carattere
strong
quando utilizzato nei paragrafi. - Esito dei dadi: Quando stiamo descrivendo cosa succede in base all'esito del tiro dei dadi, cercare di seguire questa struttura
✴Con un [range valori], [cosa succede].
. I prefissi (es.✴Con un 10+
) Saranno formattati automaticamente con lo stile caratterestrong
quando utilizzati nei paragrafi. - Non inventare esiti diversi da quelli standard: [✴Con un 10+, ✴Con un 7-9, ✴Con un 6-, ✴Con un 12+, ✴Con un 7+]
- Nomi delle mosse: Formattare i nomi delle mosse (mosse iniziali, mosse avanzate, mosse base) con lo stile carattere
em
(a esclusione di titoli e intestazioni). Questa regola prevale sulla precedente "Condizione di innesco". Es. "Quando tagli e spacchi, con un 12+ infliggi i tuoi danni e scegli qualcosa di fisico che il tuo nemico ha (un'arma, la sua posizione, un'arto): lo perde.". - Nomi delle etichette: Formattare i nomi delle etichette con lo stile carattere
em
(a esclusione di titoli e intestazioni).
template_libretto.indd
possiede al suo interno dei formattatori pre confezionati per l'impaginazione:
Sezione | Stile paragrafo | Stile carattere |
---|---|---|
Titolo di una Mossa Iniziale | BasicMoveName | |
Testo di una Mossa Iniziale | NoIndent | |
Titolo di una Mossa Avanzata | MoveName | |
Richiede/Sostituisce Mossa Avanzata | Requirement | |
Lista con checkbox | Option | |
Testo di una Mossa Avanzata | NoIndent | |
Titolo Opzione Razza/Allineamento | MoveName | |
Testo Opzione Razza/Allineamento | NoIndent | |
Istruzioni legami | NoIndent | |
Legame | p | |
Elenco Puntato | li | |
Modificatori di caratteristica (for, des, ecc) | stat | |
Riferimenti a portata, mosse, e tag nel testo | em |