Contribuire
Come contribuire allo sviluppo di OpenSTAManager
Last updated
Was this helpful?
Come contribuire allo sviluppo di OpenSTAManager
Last updated
Was this helpful?
Sei interessato a contribuire allo sviluppo di OpenSTAManger? Ottimo, sei il benvenuto!
Siamo entusiasti di ogni contributo che otteniamo dalla nostra community. Ci sono molti modi per contribuire: segnalare bug, richiedere miglioramenti, richiedere guide, proporre fix, ecc
Non serve essere degli esperti programmatori per aiutarci!
Leggi le seguenti sezioni per scoprire come ti consigliamo di procedere. Se ti serve un aiuto, crea una issue su GitHub.
Per migliorare il sistema con cui sviluppiamo il codice, abbiamo deciso di adottare alcune linee guida per facilitare la collaborazione:
Codice di condotta: Per il momento non abbiamo adottato un vero e proprio codice di condotta, ma ti chiediamo di essere il più civile possibile nel comunicare con gli altri per questo progetto.
Stile del codice: Utilizziamo principalmente due strumenti per mantenere consistente nel tempo lo stile del codice:
PHP CS Fixer viene utilizzato per formattare automaticamente il codice PHP e aumentare la sua comprensibilità. La configurazione può essere trovata nel file .
EditorConfig viene sfruttato per mantenere la consistenza nella formattazione di base dei diversi altri file utilizzati nel progetto. La configurazione può essere trovata nel file .
Maggiori informazioni sui plugin che permettono di integrare questi strumenti sono disponibili nei relativi siti.
Sei insicuro su cosa potresti lavorare per contribuire al progetto?
Prova a dare un'occhiata alle issue sotto la label , dove sono indicate le migliorie più semplici da applicare.
Se trovi un problema di sicurezza, NON aprire una issue.
Inviaci un'email all'indirizzo info@openstamanager.com
Per capire se hai individuato un problema di sicurezza, prova a farti queste domande:
Posso accedere a qualcosa a cui non dovrei avere accesso?
Posso disabilitare qualcosa per altre persone?
Se la risposta a una di queste domande è positiva, allora probabilmente hai individuato un problema di sicurezza. Considera però che anche in caso negativo potrebbe trattarsi di un problema di questo tipo, quindi se sei insicuro contattaci comunque via email.
Se vuoi suggerire una miglioria o una nuova funzionalità, sentiti libero di aprire una issue apposita dove spieghi dettagliatamente la modifica che vorresti, la sua utilità e il suo funzionamento generale, e valuteremo la tua richiesta.
Siamo presenti su:
Il progetto presenta, a partire dalla versione 2.4.2, un insieme di test per facilitare il controllo sul corretto funzionamento del gestionale.
Configurare localmente Codeception nel file codeception.yml con l'URL del web server locale
Eseguire su shell differenti i seguenti comandi:
Se hai individuato un bug e desideri segnalarlo, apri una nuova issue provando a mantenerti sulla base del .
Se sei in grado di risolvere uno dei bug segnalati oppure vuoi completare una nuova funzionalità, apri una nuova Pull Request provando a mantenerti sulla base del .
Per eseguire i test è necessario seguire le seguenti istruzioni ():
Scaricare (Selenium Server)[] e salvarlo come selenium-server-standalone.jar nella cartella principale
Scaricare (ChromeDriver)[], rendendolo eseguibile da riga di comando (su Windows, aggiungerlo al PATH)