-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore: add authors coc and contributing
- Loading branch information
Showing
4 changed files
with
204 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
(C) 2024 Francesco Del Re | ||
(C) 2024 Dipartimento per la trasformazione digitale - Presidenza del Consiglio dei Ministri | ||
|
||
The version control system provides attribution for specific lines of code. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,77 @@ | ||
# Code of Conduct | ||
|
||
## 1. Purpose | ||
|
||
A primary goal of Developers Italia is to be inclusive to the largest number of contributors, with the most varied and diverse backgrounds possible. As such, we are committed to providing a friendly, safe and welcoming environment for all, regardless of gender, sexual orientation, ability, ethnicity, socioeconomic status, and religion (or lack thereof). | ||
|
||
This code of conduct outlines our expectations for all those who participate in our community, as well as the consequences for unacceptable behavior. | ||
|
||
We invite all those who participate in Developers Italia to help us create safe and positive experiences for everyone. | ||
|
||
## 2. Open Source Citizenship | ||
|
||
A supplemental goal of this Code of Conduct is to increase open source citizenship by encouraging participants to recognize and strengthen the relationships between our actions and their effects on our community. | ||
|
||
Communities mirror the societies in which they exist and positive action is essential to counteract the many forms of inequality and abuses of power that exist in society. | ||
|
||
If you see someone who is making an extra effort to ensure our community is welcoming, friendly, and encourages all participants to contribute to the fullest extent, we want to know. | ||
|
||
## 3. Expected Behavior | ||
|
||
The following behaviors are expected and requested of all community members: | ||
|
||
- Participate in an authentic and active way. In doing so, you contribute to the health and longevity of this community. | ||
- Exercise consideration and respect in your speech and actions. | ||
- Attempt collaboration before conflict. | ||
- Refrain from demeaning, discriminatory, or harassing behavior and speech. | ||
- Be mindful of your surroundings and of your fellow participants. Alert community leaders if you notice a dangerous situation, someone in distress, or violations of this Code of Conduct, even if they seem inconsequential. | ||
- Remember that community event venues may be shared with members of the public; please be respectful to all patrons of these locations. | ||
|
||
## 4. Unacceptable Behavior | ||
|
||
The following behaviors are considered harassment and are unacceptable within our community: | ||
|
||
- Violence, threats of violence or violent language directed against another person. | ||
- Sexist, racist, homophobic, transphobic, ableist or otherwise discriminatory jokes and language. | ||
- Posting or displaying sexually explicit or violent material. | ||
- Personal insults, particularly those related to gender, sexual orientation, race, religion, or disability. | ||
- Unwelcome sexual attention. This includes, sexualized comments or jokes; inappropriate touching, groping, and unwelcomed sexual advances. | ||
- Deliberate intimidation, stalking or following (online or in person). | ||
- Advocating for, or encouraging, any of the above behavior. | ||
- Sustained disruption of community events, including talks and presentations. | ||
|
||
## 5. Consequences of Unacceptable Behavior | ||
|
||
Unacceptable behavior from any community member, including sponsors and those with decision-making authority, will not be tolerated. | ||
|
||
Anyone asked to stop unacceptable behavior is expected to comply immediately. | ||
|
||
If a community member engages in unacceptable behavior, the community organizers may take any action they deem appropriate, up to and including a temporary ban or permanent expulsion from the community without warning. | ||
|
||
## 6. Reporting Guidelines | ||
|
||
If you are subject to or witness unacceptable behavior, or have any other concerns, please notify a community organizer as soon as possible. You can do so by e-mailing [email protected]. | ||
|
||
Additionally, community organizers are available to help community members engage with local law enforcement or to otherwise help those experiencing unacceptable behavior feel safe. In the context of in-person events, organizers will also provide escorts as desired by the person experiencing distress. | ||
|
||
## 7. Addressing Grievances | ||
|
||
If you feel you have been falsely or unfairly accused of violating this Code of Conduct, you should notify the managers of Developers Italia with a concise description of your grievance. Your grievance will be handled in accordance with our existing governing policies. | ||
|
||
## 8. Scope | ||
|
||
We expect all community participants (contributors, paid or otherwise; sponsors; and other guests) to abide by this Code of Conduct in all community venues–online and in-person–as well as in all one-on-one communications pertaining to community business. | ||
|
||
This code of conduct and its related procedures also applies to unacceptable behavior occurring outside the scope of community activities when such behavior has the potential to adversely affect the safety and well-being of community members. | ||
|
||
## 9. Contact info | ||
|
||
You can reach the managers of Developers Italia at [email protected] | ||
|
||
## 10. License and attribution | ||
|
||
This Code of Conduct is distributed under a [Creative Commons Attribution-ShareAlike license](http://creativecommons.org/licenses/by-sa/3.0/). | ||
|
||
Portions of text derived from the [Django Code of Conduct](https://www.djangoproject.com/conduct/) and the [Geek Feminism Anti-Harassment Policy](http://geekfeminism.wikia.com/wiki/Conference_anti-harassment/Policy). | ||
|
||
Retrieved on November 22, 2016 from [http://citizencodeofconduct.org/](http://citizencodeofconduct.org/) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,69 @@ | ||
# Codice di condotta | ||
|
||
## 1. Scopo | ||
|
||
Uno degli obiettivi principali di Developers Italia è quello di includere il maggior numero di contributori, con il background più vario e diversificato possibile. Pertanto, ci impegniamo a fornire un ambiente amichevole, sicuro e accogliente per tutti, indipendentemente dal genere, dall'orientamento sessuale, dalle abilità, dall'etnia, dallo status socioeconomico e dalla religione (o dalla sua mancanza). | ||
|
||
Questo codice di condotta delinea le nostre aspettative per tutti coloro che partecipano alla nostra comunità, nonché le conseguenze per comportamenti inaccettabili. | ||
|
||
Invitiamo tutti coloro che partecipano a Developers Italia a aiutarci a creare esperienze positive e positive per tutti. | ||
|
||
## 2. Cittadinanza open source | ||
|
||
Un obiettivo supplementare di questo Codice di condotta è aumentare la cittadinanza open source incoraggiando i partecipanti a riconoscere e rafforzare le relazioni tra le nostre azioni e i loro effetti sulla nostra comunità. | ||
|
||
Le comunità rispecchiano le società in cui esistono e l'azione positiva è essenziale per contrastare le molte forme di disuguaglianza e abusi di potere che esistono nella società. | ||
|
||
Se vedi qualcuno che sta facendo uno sforzo in più per garantire che la nostra comunità sia accogliente, amichevole e incoraggia tutti i partecipanti a contribuire nella massima misura, vogliamo sapere. | ||
|
||
## 3. Comportamento previsto | ||
|
||
I seguenti comportamenti sono previsti e richiesti a tutti i membri della comunità: | ||
|
||
- Partecipare in modo autentico e attivo. In tal modo, contribuisci alla salute e alla longevità di questa comunità. | ||
- Esercitare considerazione e rispetto nei propri discorsi e azioni. | ||
- Tentativo di collaborazione prima del conflitto. | ||
- Astenersi dal comportamento umiliante, discriminatorio o molesto. | ||
- Sii consapevole di ciò che ti circonda e dei tuoi compagni partecipanti. Avvisare i leader della comunità se si nota una situazione pericolosa, qualcuno in difficoltà o violazioni di questo Codice di condotta, anche se sembrano irrilevanti. | ||
- Ricorda che le sedi di eventi comunitari possono essere condivise con membri del pubblico; si prega di essere rispettosi verso tutti i clienti di questi luoghi. | ||
|
||
## 4. Comportamento inaccettabile | ||
|
||
I seguenti comportamenti sono considerati molestie e inaccettabili all'interno della nostra comunità: | ||
|
||
- Violenza, minacce di violenza o linguaggio violento diretto contro un'altra persona. | ||
- Scherzi e linguaggio sessista, razzista, omofobo, transfobico, o comunque discriminatorio. | ||
- Pubblicare o visualizzare materiale sessualmente esplicito o violento. | ||
- Insulti personali, in particolare quelli relativi al genere, orientamento sessuale, razza, religione o disabilità. | ||
- Attenzione sessuale sgradita. Ciò include commenti o battute sessualizzate; approcci sessuali inappropriati, toccanti e indesiderati. | ||
- Intimidazione intenzionale, stalking o seguito (online o di persona). | ||
- Sostenendo o incoraggiando uno qualsiasi dei suddetti comportamenti. | ||
- Perturbazione continua degli eventi della comunità, inclusi discorsi e presentazioni. | ||
|
||
## 5. Conseguenze del comportamento inaccettabile | ||
|
||
Il comportamento inaccettabile da parte di qualsiasi membro della comunità, inclusi gli sponsor e coloro che hanno l'autorità decisionale, non sarà tollerato. | ||
|
||
Ci si aspetta che chiunque chieda di smettere di comportarsi in modo inaccettabile si adegui immediatamente. | ||
|
||
Se un membro della comunità si comporta in modo inaccettabile, gli organizzatori della comunità possono intraprendere qualsiasi azione che ritengano appropriata, fino a includere un divieto temporaneo o l'espulsione definitiva dalla comunità senza preavviso. | ||
|
||
## 6. Linee guida per la segnalazione | ||
|
||
Se sei soggetto a un comportamento inaccettabile o ne sei testimone o se hai altre preoccupazioni, ti preghiamo di avvisare un organizzatore della comunità il prima possibile. Puoi farlo inviando una e-mail a `[email protected]`. | ||
|
||
Inoltre, gli organizzatori della comunità sono disponibili per aiutare i membri della comunità a impegnarsi con le forze dell'ordine locali o per aiutare altrimenti coloro che vivono comportamenti inaccettabili a sentirsi al sicuro. Nel contesto di eventi di persona, gli organizzatori forniranno anche le scorte come desiderato dalla persona che soffre. | ||
|
||
## 7. Affrontare i reclami | ||
|
||
Se ritieni di essere stato accusato ingiustamente di violare questo Codice di condotta, dovresti informare i gestori di Developers Italia con una descrizione sintetica del tuo reclamo. Il tuo reclamo verrà gestito in conformità con le nostre attuali politiche di governance. | ||
|
||
## 8. Ambito di applicazione | ||
|
||
Ci aspettiamo che tutti i partecipanti alla comunità (contributori, pagati o meno, sponsor e altri ospiti) si attengano a questo Codice di condotta in tutte le sedi della comunità, online e di persona, nonché in tutte le comunicazioni individuali relative alla comunità attività commerciale. | ||
|
||
Questo codice di condotta e le relative procedure si applicano anche a comportamenti inaccettabili che si verificano al di fuori dell'ambito delle attività della comunità quando tale comportamento ha il potenziale di influire negativamente sulla sicurezza e il benessere dei membri della comunità. | ||
|
||
## 9. Informazioni di contatto | ||
|
||
Puoi raggiungere i gestori di Developers Italia all'indirizzo `[email protected]`. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,54 @@ | ||
# Contribuire a questo progetto | ||
|
||
Prenditi un momento per leggere questo documento così da rendere il processo semplice e consistente con quello utilizzato | ||
dal resto della comunità degli sviluppatori. | ||
|
||
## Creare una issue | ||
|
||
L'[issue tracker](https://github.com/italia/pdnd-client-assertion-generator/issues) è il posto giusto dove inserire segnalazioni di bug, | ||
richieste di nuove funzionalità e creazione di pull request, nel rispetto di queste condizioni: | ||
|
||
- Per favore, **non** usare l'issue tracker per richieste di supporto personali. | ||
[Slack di Developers Italia](https://slack.developers.italia.it/) o Stack Overflow sono i posti giusti a cui fare riferimento, dove sarà anche più facile trovare risposte immediate. | ||
- Allo stesso modo, per favore **non** provocare gli altri o "trollare" nei commenti alle issue. | ||
Mantenere la discussione pertinente e rispettare le opinioni di tutti. Per confronti o questioni più articolate, | ||
è sempre auspicabile usare [Slack di Developers Italia](https://slack.developers.italia.it/) o il [Forum di Developers Italia](https://forum.italia.it/). | ||
- Rispettare le indicazioni che trovate di seguito per l'utilizzo di label, la segnalazione di bug, e la creazione di pull request. | ||
|
||
## Lavorazione di una issue | ||
|
||
Per prendere in carico una issue, è necessario effettuare il fork del repository sul proprio account, secondo il normale flusso GitHub. | ||
|
||
Il flow da seguire per lo sviluppo è semplificato rispetto a un git-flow standard, per permettere una maggior velocità di sviluppo, e la creazione di una history leggibile. | ||
|
||
- Qualsiasi cosa nel ramo principale (main) è definita come stabile e potenzialmente deployabile. | ||
- Per lavorare su qualcosa di nuovo, creare un nuovo branch da main e assegnare un nome descrittivo: | ||
|
||
1. in caso di una nuova feature `feat/nome_della_feature` (es: feat/new-button-component) | ||
2. in caso di fix `fix/nome_descrittivo_<numero_issue>` (es: fix/focus_textarea_252) | ||
|
||
- Al termine della lavorazione, per proporre il proprio codice per l'approvazione, è sufficiente aprire una Pull Request ([qui](https://help.github.com/articles/creating-a-pull-request-from-a-fork/) le istruzioni nel caso di fork). | ||
|
||
I criteri da seguire durante il lavoro sulle feature e sulle issue sono i seguenti: | ||
|
||
- Utilizzare lo standard [Conventional Commit](https://www.conventionalcommits.org/en/v1.0.0/) per scrivere messaggi di commit leggibili e standardizzati | ||
- In caso di vari commit su un branch che non aggiungono informazione alla feature o al fix in questione (ad esempio fix: revert last work o chore: typo in documentation) meglio fare uno squash dei vari commit (o richiedere di farlo a chi mergerà la PR in questione) | ||
- Cercare di allinearsi a main prima di richiedere una review, utilizzando rebase o merge (https://amerlin.keantex.com/git-merge-vs-rebase/) e risolvendo eventuali conflitti. | ||
|
||
## Issue e label | ||
|
||
Il repository usa alcune label per identificare le issue (criticità), tra le principali troviamo: | ||
|
||
- `bug` - Segnalazione di malfunzionamenti nel codice o problemi tecnici con i tool di compilazione. | ||
- `docs` - Criticità riguardanti la documentazione dei componenti. | ||
- `duplicate` - Criticità o pull request duplicata. | ||
- `enhancement` - Criticità che possono riguardare nuovi componenti o nuove funzionalità. | ||
- `good first issue` - Criticità particolarmente semplici da prendere in carico per chi non ha conoscenza approfondita del progetto. | ||
- `help wanted` - Criticità pronte per ricevere contributi da parte della comunità e di nuovi aspiranti sviluppatori. | ||
- `invalid` - Criticità considerata invalida. | ||
- `question` - Indica una criticità o pull request per la quale si ha bisogno di maggiori informazioni. | ||
- `wontfix` - Indica che la criticità o la pull request viene chiusa senza alcun lavoro aggiuntivo. | ||
|
||
## Licenza | ||
|
||
Contribuendo al codice o alla documentazione accetti di rilasciare il tuo codice secondo la licenza open source già presente nel repository. |