diff --git a/CONTRIBUTING-it.md b/CONTRIBUTING-it.md index b541511a..3bdc4e18 100644 --- a/CONTRIBUTING-it.md +++ b/CONTRIBUTING-it.md @@ -45,7 +45,8 @@ I collaboratori accettano di rispettare il [Codice di Comportamento](https://git - preferisci gli atomic commits (un commit per aggiunta/modifica/eliminazione) rispetto ai grandi commit. Non c'è bisogno di raggruppare i commit per inviarli in una sola PR. (Non applichiamo mai questa regola, è solo per comodità dei moderatori) - se il libro è più vecchio, includi la data di pubblicazione assieme al titolo. - includi il nome o i nomi degli autori se è il caso. Puoi accorciare il nome degli autori con "et al." -- se il libro non è ancora finito, e ci stanno ancora lavorando su, aggiungi "in process", come descritto [qui sotto.](#in_process) +- se il libro non è ancora finito, e ci stanno ancora lavorando su, aggiungi "in process", come descritto [qui sotto](#in_process). Seleziona sempre l'ultima versione disponibile in questi siti. +- se una risorsa è archiviata usando la Wayback Machine di Internet Archive (o simili), aggiungi la notazione "archived", come descritto [qui sotto](#archived). La versione migliore da utilizzare è quella più recente/completa. - se è richiesto un indirizzo email o un account per poter scaricare il libro, aggiungilo tra parentesi, esempio: `(email address *requested*, not required)` @@ -121,6 +122,13 @@ CORRETTO: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane R CORRETTO: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) ``` + +- Link archiviato: + +``` +CORRETTO: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* +``` + ### Note Mentre le basi sono relativamente semplici, c'è una notevole differenza tra le risorse che inseriamo nelle liste. Qui ci sono alcuni appunti su come affrontiamo queste diversità. @@ -147,7 +155,7 @@ I nostri elenchi forniscono un set minimo di metadati: titoli, URLs, autori, pia - Vogliamo dare i crediti agli autori ove appropriato, anche ai traduttori! - Per i lavori tradotti, l'autore originale dovrebbe essere incluso. - Non permettiamo collegamenti per gli autori. -- Per le compilation o remix, il "creatore" potrebbe aver bisogno di una descrizione. Ad esempio, i libri "GoalKicker" sono accreditati come "Compiled from StackOverflow documentation" +- Per le compilation o remix, il "creatore" potrebbe aver bisogno di una descrizione. Ad esempio, i libri "GoalKicker" o "RIP Tutorial" sono accreditati come "Compiled from StackOverflow documentation" ##### Piattaforme e note di accesso diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 27d3bbc4..ccb0076b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -45,6 +45,7 @@ By contributing you agree to respect the [Code of Conduct](https://github.com/Eb - if the book is older, include the publication date with the title. - include the author name or names where appropriate. You can shorten author lists with "et al." - if the book is not finished, and is still being worked on, add the "in process" notation, as described [below.](#in_process) +- if a resource is restored using the Internet Archive's Wayback Machine (or similar), add the "archived" notation, as described [below](#archived). The best versions to use are recent and complete. - if an email address or account setup is requested before download is enabled, add language-appropriate notes in parentheses, e.g.: `(email address *requested*, not required)` ### Formatting @@ -119,6 +120,13 @@ GOOD: * [A Very Awesome Book (1970)](https://example.org/book.html) - Jane Roe GOOD: * [Will Be An Awesome Book Soon](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) ``` + +- Archived link: + +``` +GOOD: * [A Way-backed Interesting Book](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) *(:card_file_box: archived)* +``` + ### Notes While the basics are relatively simple, there is a great diversity in the resources we list. Here are some notes on how we deal with this diversity. @@ -145,7 +153,7 @@ Our lists provide a minimal set of metadata: titles, URLs, creators, platforms, - We want to credit the creators of free resources where appropriate, including translators! - For translated works the original author should be credited. - We do not permit links for Creators. -- For compilation or remixed works, the "creator" may need a description. For example, "GoalKicker" books are credited as "Compiled from StackOverflow documentation" +- For compilation or remixed works, the "creator" may need a description. For example, "GoalKicker" or "RIP Tutorial" books are credited as "Compiled from StackOverflow documentation" ##### Platforms and Access Notes