Questo README.md file è disponibile anche in Olandese (README-Dutch), Francese (README-French.md), Tedesco (README-German.md), Indonesiano (README-Indonesian), Coreano (README-Korean), Portoghese (README-Portuguese), e Spagnolo (README-Spanish) (ordine alfabetico nella versione originale in Inglese).
Contributori Totali:
Informazioni | Links |
---|---|
Progetto | |
News | |
Chat | |
Build | |
Cita |
Benvenuti nel GitHub repository per The Turing Way. Qui è dove tutte le parti del progetto vengono sviluppate, riviste e tenute aggiornate.
The Turing Way è una guida per condurre data science in maniera riproducibile, etica e collaborativa. Coinvolgiamo e sosteniamo una comunità eterogenea di contributori in modo da rendere data science accessibile, comprensibile ed efficace per tutti. Il nostro obiettivo è quello di fornire tutte le informazioni di cui i ricercatori e i data scientists (che siano in ambito accademico, industriale o nel settore pubblico) hanno bisogno all'inizio dei loro progetti in modo che questi siano poi facili da riprodurre.
The Turing Way è un libro, una comunità e una collaborazione globale.
Tutte le parti interessate, tra cui studenti, ricercatori, software engineers, capi progetto e team di finanziamento, sono incoraggiati a usare The Turing Way per capire i propri ruoli e responsabilità nella riproducibilità in data science. Puoi leggere il libro online, contribuire al progetto come dettagliato in questa guida e riusare tutti i materiali (controlla la licenza).
Screenshot del libro The Turing Way online (usa questa immagine in una presentazione)
Il libro The Turing Way è iniziato come una guida con un taglio deciso nel 2019 e si è gradualmente trasformato in una serie di guide su Ricerca Riproducibile, Design di Progetti, Comunicazione, Collaborazione e Ricerca Etica. Ogni guida comprende capitoli su diversi argomenti e include le migliori pratiche da adottare, indicazioni e raccomandazioni. Questi capitoli sono stati scritti in collaborazione con studenti, ricercatori, educatori, ledear della comunità, politici e professionisti con background eterogeneo, esperienze vissute e conoscenze di settore.
La nostra chimera è di rendere la reproducibilità "troppo facile da non fare".
Indice:
- Il Progetto
- Il Team
- Come Contribuire
- Citare The Turing Way
- Citare le immagini di The Turing Way
- Contattaci
- Collaboratori
🎧 Se preferisci un'introduzione audio al progetto, Rachael ha partecipato all'Open Science Fair 2019 (Porto, Portogallo) e la sua presentazione è disponibile su Orion podcast. Una panoramica di The Turing Way inizia al minuto 5:13 (in Inglese).
La riproducibilità della ricerca è necessaria per garantire l'affidabilità del lavoro scientifico. Finanziatori ed editori richiedono sempre più spesso che le pubblicazioni includano l'accesso ai dati grezzi ed al codice sorgente. L'obiettivo è quello di garantire che tutti i risultati siano verificabili in maniera indipendente e possano essere usati come punto di partenza in lavori futuri. Tutto questo a volte è più facile a dirsi che a farsi. Condividere i risultati della ricerca significa comprendere la gestione dei dati, lo sviluppo del software, le scienze bibliografiche e le tecniche di integrazione continua: competenze che non sono ben spiegate o richieste ad accademici e data scientist. Non essendo queste materie comunemente insegnate, riconosciamo che il numero di requisiti e nuove competenze richieste possano essere un problema per i neofiti. The Turing Way è un manuale per aiutare gli studenti, i loro supervisori, finanziatori ed editori a rendere la riproducibilità in data science "troppo facile da non fare", anche per coloro che non hanno mai lavorato in questo modo. Il manuale comprende materiale di formazione sul version control, test di analisi e comunicazione aperta e trasparente con i nuovi utenti e si baserà su casi di studio e workshop del Turing Institute. Questo progetto è sviluppato in maniera aperta e nel nostro repository GitHub sono benvenuti suggerimenti, domande e commenti: https://github.com/the-turing-way/the-turing-way.
The Turing Way è una collaborazione aperta e guidata dalla comunità. Chiunque partecipi a questo libro, indipendentemente dall'importanza del contributo, è riconosciuto in questo progetto come contributore e membro della comunità. Collaboratori di lunga data sono considerati come collaboratori principali ed hanno ruoli di leadership all'interno del progetto. Il progetto è coordinato da Kirstie Whitaker (founder) e Malvika Sharan (community developer) ed è ospitato dal The Alan Turing Institute.
Per maggiori informazioni, puoi leggere questa guida e la Lista dei Contributori per capire come riconosciamo il tuo lavoro e come i nostri contributori sono messi in evidenza nel progetto.
Consulta l'elenco dei collaboratori per i profili GitHub di tutti i contributori.
🚧 Questo repository è sempre in costruzione e tutti sono incoraggiati ad aiutarci in questo progetto che può essere utile a molti. 🚧
Tutti sono tenuti a seguire il nostro codice di condotta e a leggere le nostre linee guida per avere più informazioni su come iniziare. Vogliamo rendere la contribuzione a questo progetto il più facile possibile. Per questo motivo, ci sono diversi modi in cui è possibile contribuire in base ai propri interessi, disponibilità e capacità.
Tra i modi di contribuire ci sono anche lo sviluppo e la condivisione di nuovi capitoli, la manutenzione e il miglioramento dei capitoli esistenti, la condivisione delle risorse de The Turing Way, la revisione e l'aggiornamento del materiale, la traduzione dei capitoli per rendere questo progetto accessibile globalmente, la condivisione delle miglior pratiche nell'amito della ricerca.
Ai membri della comunità vengono date opportunità per imparare nuove abilità, condividere le proprie idee e collaborare con altri. Questa comunità rende possibile per i propri membri, e li incoraggia, a fare da guida per contribuzioni a The Turing way e ad altri progetti open source.
Abbiamo creato un promotion pack per aiutarti a presentare e condividere The Turing Way.
Puoi citare The Turing Way attraverso l'archivio del progetto Zenodo usando il DOI: 10.5281/zenodo.3233853. Il DOI (digital object identifier) ci permette di archiviare i repository ed è molto utile per garantire che il lavoro venga tracciato nelle pubblicazioni accademiche.
Come apparirà la citazione:
The Turing Way Community, Becky Arnold, Louise Bowler, Sarah Gibson, Patricia Herterich, Rosie Higman, … Kirstie Whitaker. (2019, March 25). The Turing Way: A Handbook for Reproducible Data Science (Version v0.0.4). Zenodo. http://doi.org/10.5281/zenodo.3233986
Puoi anche condividere una pagina del manuale usando un URL leggibile, per esempio: https://book.the-turing-way.org/reproducibility/03/definitions.html, ma ricorda che il progetto è in via di sviluppo e perciò i link potrebbero cambiare nel tempo. Potresti includere un link del web archive, ad esempio: https://web.archive.org/web/20191030093753/https://book.the-turing-way.org/reproducibility/03/definitions.html per essere sicuro di non ritrovarti ovunque con collegamenti obsoleti (broken links)!
Apprezziamo molto qualsiasi tipo di riferimento al progetto The Turing Way . Se hai ancora dei dubbi o delle domande contattaci.
Le illustrazioni su The Turing Way sono state create da artisti di Scriberia durante i The Turing Way book dashes il 17 maggio 2019 a Manchester ed il 28 maggio 2019 e il 21 febbraio 2020 a Londra. Descrivono una varietà di contenuti del manuale, gli sforzi collaborativi della community e il progetto The Turing Way in generale.
Le illustrazioni sono disponibili su Zenodo (https://zenodo.org/record/3695300) sotto licenza CC-BY.
Se utilizzi le immagini, includi la seguente attribuzione:
This image was created by Scriberia for The Turing Way community and is used under a CC-BY licence.
L'ultima versione di Zenodo può essere menzionata come:
The Turing Way Community, & Scriberia. (2020, March 3). Illustrations from the Turing Way book dashes. Zenodo. http://doi.org/10.5281/zenodo.3695300
Abbiamo utilizzato alcune di queste immagini nelle risposte del Welcome Bot ai contributi dei nuovi membri nel nostro repository su GitHub.
(In inglese)
Puoi contattare il team The Turing Way scrivendo a theturingway@gmail.com.
In alternativa, puoi contattare Malvika Sharan tramite msharan@turing.ac.uk oppure Kirstie Whitaker scrivendo a kwhitaker@turing.ac.uk.
Discuti le tue idee e connetti con altri su Slack usando questo invito.
Abbiamo una chat room su Gitter (se preferisci un'alternativa open source) e ci farebbe piacere se passassi a salutarci a https://gitter.im/the-turing-way/the-turing-way. La chat room è sincronizzata con Matrix su #the-turing-way:matrix.org e puoi raggiungerci anche qui se preferisci.
Abbiamo anche una mailing list su tinyletter con la quale inviamo aggiornamenti mensili sul progetto. Iscriviti a questo link https://tinyletter.com/TuringWay.
Puoi anche seguirci su Twitter (@turingway).
Vorremmo ringraziare queste persone meravigliose (emoji key):
Elenco di persone che hanno collaborato
Questo progetto segue le specifiche riportate su all-contributors. Ogni tipo di contributo è gradito!