diff --git a/struct-wikipages/en/Hacker b/struct-wikipages/en/Hacker new file mode 100644 index 0000000..bfde515 --- /dev/null +++ b/struct-wikipages/en/Hacker @@ -0,0 +1,28 @@ +Do you want to help WikiToLearn "under the hood"? This is the right page for you to get started! First of all, you do not need to be a super expert in Computer Science: there are plenty of things to do at all skill levels. You can also count on the help of our developers to help get you on track to contribute immediately!! + +== Guide for the development == +You can find the complete guide for the development of the website [http://meta.wikitolearn.org/Guide_for_the_development_of_WikiToLearn Guide for the development of WikiToLearn]. + +== Code == +Let's talk about the code: all the code for WikiToLearn is open-source, of course, and you can find it on GitHub +https://github.com/WikiToLearn + +===Git=== +Git is a software tool used to manage large projects collaboratively, as efficiently as possible. WikiToLearn uses Git to manage the updates and all the changes of the project. You can clone the repositories and start exploring the code right now. + +To install Git: https://git-scm.com/ + +Here is a 15 minutes guided tutorial to learn how to use it: https://try.github.io/levels/1/challenges/1. + +A full git tutorial is provided by Atlassian here: https://www.atlassian.com/git/ + +You can find another guide, still in Beta yet extremely simple, on codeacademy: https://www.codecademy.com/courses/learn-git + +A cheat sheet with the most used commands is always handy: http://ktown.kde.org/~zrusin/git/git-cheat-sheet.svg + +===Docker=== +Docker is a software used by WikiToLearn to divide the project into different modules. You can think of the dockers as large containers optimized for a particular application. To run WikiToLearn you will need to install Docker. Read here to get started: +http://docs.docker.com/linux/started/ + +=== Programming languages === +WikiToLearn is a big project. As a result, it employs many different web technologies and development environments. In particular, there are a few prevalent languages such as Python, PHP, CSS, HTML and JavaScript. diff --git a/struct-wikipages/en/Professor b/struct-wikipages/en/Professor new file mode 100644 index 0000000..69f2f8e --- /dev/null +++ b/struct-wikipages/en/Professor @@ -0,0 +1,22 @@ +We are very happy you are here. Your knowledge is fundamental to ensure high standards for the content on WikiToLearn - to make it reliable and complete. + +== Step 1: Getting started == +Start from your main area of interest or research. Search on the website if there are some notes already written about it, review and improve them. Keep '''[[WikiToLearn_Manual|this guide]]''' on hand to learn how to apply changes or additions to the pages. +On the other hand, if you couldn’t find any existing material suitable to your courses, pick from your notes to '''[[WikiToLearn_Manual/How_to_write_a_topic|create a new course or add new chapters]]'''. in an already existing one. + +You can use [[WikiToLearn_Manual|the WikiToLearn manual]] as a really good resource. + +In case you have already written something in LaTeX, our LaTeX to Wiki converter is exactly what you need: read '''[[WikiToLearn_Manual/LaTeX_materials_on_wiki|here]]''' how to import your text. + +== Step 2: Engage your students == +The collaboration between you and your students on WikiToLearn has a unique potential both for them and for you, as well as for the project itself: don’t miss out on the opportunity to contribute a large amount of free knowledge to the whole world! + +The students will consolidate their knowledge by writing their notes in a more organized way and, thanks to your thorough checking and improving, they will be able to create evolving, exhaustive, proofread and beautifully formatted textbooks. + +Reviewing the notes of your students will help you to be aware of their understanding of each lesson, which gives you valuable feedback on the effectiveness of your teaching. You can then customize your classes in order to optimize the educational path. + +The resources on WikiToLearn are growing thanks to the contribution of researchers and professors like you, who are collaborating together to make educational material freely accessible, reliable and complete. + + +== Step 3: Spread the word == +Do not narrow the project to your class: invite your colleagues and all the institutions you are involved with to collaborate with us to help the project spread. By building such a growing network, both the quantity and the quality of the resources available will continuously improve! diff --git a/struct-wikipages/en/Student b/struct-wikipages/en/Student new file mode 100644 index 0000000..36170b1 --- /dev/null +++ b/struct-wikipages/en/Student @@ -0,0 +1,26 @@ +Are you a student willing to participate in WikiToLearn? Awesome! We have thought of some great ways for you to participate. Here are some guidelines that offer you a perspective of what is possible to help you get started: + +Surely you have already got some '''class notes''', though perhaps they are incomplete, poorly organised or not very easy to understand. Why not clean them up a bit and share them on WikiToLearn? + +Not only will you learn by re-working your notes, but you will then have a convenient, clear and complete text, which will be much much easier for you to study! By collaborating on WikiToLearn, you will be part of a large project creating free texts, in which many other people contribute to the collection of notes, either by submitting new ones or improving existing ones. + +== Step 1: Getting started == +Let's begin with something that you have already done: do you have particularly well written notes that you would like to share? +* If the related course does not yet exist on WikiToLearn, '''[[Manual/Core concepts: Course|create it]]'''. +* If the course already exists, but the specific topics you want to write about are not present, find out how to '''[[Manual/Core concepts: Section|add new chapters]]'''. +* If you want to create concurrent versions of already existing chapters, first evaluate whether it would be best just to improve the current version. As a rule of thumb, we try to avoid duplicating already written material, but if you believe that you have new suggestions, remember that we enthusiastically support field testing. +* If you think that everything already exists, and you don't feel like creating something new, simply print all the material you need and start learning from it! There is no better way to help us improve our material than to study from it and give us your feedback. + +If you have already typed your notes in LaTeX, don't worry, our LaTeX to Wiki converter is just what you need: learn [[Manual/Importing from LaTeX|here]] how to import your text! + +If this is the first time you are contributing on WikiToLearn, see the [[Manual|Manual]]. + +== Step 2: Engage your group == +A strategy that we often see working well is to find 3 or 4 friends and form a group with them. You should then split the classes between you according to a set calendar, writing and reviewing the notes in turns. With less than a couple hours per week of work, you will gain a beautiful copy of the lessons, even better than a textbook, and you will optimise the time for your study. + +== Step 3: Spread the word == +There is more! Are you a representative or involved in any student organizations? Talk about WikiToLearn with other students! You would be surprised how many of them would love to use or contribute to something like this. + +Show them how it works and before you know it a local group within your University will kick off. Introduce the project to your professors as well, they can improve and proofread your notes or, who knows, maybe even participate with their own lecture notes! + +With more people involved, everybody gains! diff --git a/struct-wikipages/it/Hacker b/struct-wikipages/it/Hacker new file mode 100644 index 0000000..fe67f35 --- /dev/null +++ b/struct-wikipages/it/Hacker @@ -0,0 +1,35 @@ +Vuoi aiutare WikiToLearn "sotto il cofano"? Questa è la pagina giusta per iniziare. +Prima di tutto, non è necessario essere dei super esperti di informatica: ci sono moltissime cose da fare a tutti i livelli di difficoltà. In ogni momento potrai contare sull'aiuto dei nostri sviluppatori per imparare ed entrare nel vivo dello sviluppo! + +==Guida allo sviluppo== +Su [http://meta.wikitolearn.org meta.wikitolearn] potete trovare la guida completa allo sviluppo di WikiToLearn: [http://meta.wikitolearn.org/Guida_allo_sviluppo_di_WikiToLearn Guida allo sviluppo di WikiToLearn] + +==Codice== +Ma parliamo di codice... +Tutto il codice di WikiToLearn è ovviamente open-source e si trova su GitHub https://github.com/WikiToLearn. + +Le nostre task sono su: https://phabricator.kde.org/project/board/39/ + +===Git=== +Git è un software utilizzato per gestire grandi progetti in modo collaborativo nella maniera più efficiente e pratica possibile. WikiToLearn utilizza Git per gestire gli aggiornamenti e le modifiche del progetto. Puoi subito clonare i repository e iniziare a esplorare il codice. +Per installare Git: +https://git-scm.com/ + +Se hai bisogno di un introduzione all'uso di Git puoi provare il tutorial guidato a questo link: +https://try.github.io/levels/1/challenges/1. + +Una guida ancora in fase beta, ma molto molto semplice è su codeacademy: +https://www.codecademy.com/courses/learn-git + +Se invece vuoi una guida in italiano molto sintetica ed efficiente prova a guardare qua: http://rogerdudler.github.io/git-guide/index.it.html + +Per un elenco di comandi sempre a portata di mano un cheat sheet è sempre comodo: +http://ktown.kde.org/~zrusin/git/git-cheat-sheet.svg + +===Docker=== +Docker è un software utilizzato da WikiToLearn per rendere il progetto suddiviso in vari moduli. Puoi pensare ai docker come dei grandi contenitori ottimizzati per una determinata applicazione. +Per far girare WikiToLearn hai bisogno di un'installazione di Docker. Per iniziare:
+http://docs.docker.com/linux/started/ + +===Linguaggi di sviluppo=== +WikiToLearn è un grande progetto. Come conseguenza, vengono utilizzate molte tecnologie web e diversi ambienti di sviluppo. In particolare, c'è un forte utilizzo di linguaggi come Python, Php, CSS, HTML e Javascript. diff --git a/struct-wikipages/it/Professore b/struct-wikipages/it/Professore new file mode 100644 index 0000000..ed626f1 --- /dev/null +++ b/struct-wikipages/it/Professore @@ -0,0 +1,23 @@ +{{PiccolaInfobox}} +Siamo felici di averti qui! Le tue competenze sono fondamentali per migliorare la qualità del materiale su WikiToLearn rendendolo affidabile e completo. +== Fase 1: Per cominciare == +Perché non cominciare dalle tue principali aree di interesse o di ricerca? +Cerca se sul sito sono presenti delle note riguardanti quegli argomenti, controllale, correggile e segnalalo (quando le hai riguardate) in modo da aumentare il punteggio affidabilità della pagina. +Per scoprire come intervenire sulle pagine tieni sotto mano '''[[WikiToLearn_Manual|questa guida]]'''. + +Se, invece, non esiste ancora del materiale in uno dei tuoi campi d’interesse, '''[[WikiToLearn_Manual/How_to_write_a_topic|crea tu un nuovo corso o aggiungi capitoli]]''' in un corso già esistente. + +Nel caso tu abbia già scritto qualcosa in LaTeX, abbiamo realizzato un convertitore in grado di importare la tua dispensa! Per sapere come importare il tuo testo, '''[[WikiToLearn_Manual/LaTeX_materials_on_wiki|leggi qui]]'''. + +== Fase 2: Coinvolgi i tuoi studenti == +La collaborazione tra te e i tuoi studenti su WikiToLearn ha un potenziale unico sia per loro sia per te sia per WikiToLearn: cogli l’occasione di contribuire una grande quantità di contenuto libero per tutto il mondo! + +Gli studenti consolideranno le loro conoscenze scrivendo gli appunti in modo organizzato e, grazie alle tue correzioni, avranno la possibilità di creare dei veri e propri libri esaustivi e in evoluzione. + +Revisionare gli appunti dei tuoi studenti ti aiuterà, inoltre, a restare sempre al corrente rispetto alla comprensione delle tue lezioni, fornendoti un utile feedback sulla loro efficacia. Potrai così personalizzare le spiegazioni in modo da ottimizzare il percorso educativo. + +Le risorse di WikiToLearn sono in continua crescita grazie al contributo sempre maggiore di ricercatori e professori che, come te, collaborano per rendere fruibile liberamente materiale didattico, affidabile e completo. + +== Fase 3: Spargi la voce == +Non limitarti ad adottare il progetto nelle tue classi: invita i tuoi colleghi e le istituzioni di cui fai parte a collaborare con te e a diffondere l’utilizzo del progetto. +Costruendo una rete sempre più estesa, sia la quantità che la qualità del materiale disponibile cresceranno a dismisura! diff --git a/struct-wikipages/it/Studente b/struct-wikipages/it/Studente new file mode 100644 index 0000000..d079e86 --- /dev/null +++ b/struct-wikipages/it/Studente @@ -0,0 +1,27 @@ +Sei uno studente e vuoi partecipare a WikiToLearn? Nulla di più semplice! Abbiamo pensato ad alcune forme con cui tu possa partecipare al meglio. Quelle qui sotto solo linee guida, ma possono esserti utili per capire come lavorare al meglio. + +Sicuramente hai già degli '''appunti''' che forse però sono poco comprensibili, incompleti o male organizzati. Perché non rielaborarli in una versione migliore e condividerli su WikiToLearn? +Oltre ad imparare scrivendo, avrai sempre a disposizione un comodo testo, chiaro e completo su cui sarà più facile studiare! +Partecipando a WikiToLearn entrerai a far parte di un grande progetto di scrittura di testi liberi, in cui moltissimi altri utenti contribuiscono alla raccolta di appunti, sia creandone di nuovi sia migliorando quelli già esistenti. + +== Fase 1: Per cominciare == +Iniziamo da quello che hai già scritto: hai degli appunti particolarmente ben fatti che ti piacerebbe condividere? +* Se il corso non esiste ancora su WikiToLearn '''[[Manual/Core concepts: Course|crealo]]'''. +* Se esiste ma non esistono ancora i capitoli che vuoi trattare '''[[Manual/Core concepts: Section|scopri come aggiungerli]]'''. +* Se vuoi creare versioni parallele di capitoli già esistenti, prima di tutto verifica che tu non possa già sistemare e correggere quelli che già ci sono. Generalmente cerchiamo di evitare di duplicare corsi o lavoro, ove possibile, ma se credi di avere nuove proposte, siamo estremamente favorevoli a sperimentare nuove idee direttamente sul campo. +* Se esiste già tutto, e non ti senti in grado di creare qualcosa di nuovo, semplicemente stampa i capitoli già presenti e studiaci sopra! Non esiste niente come uno studio approfondito per potere trovare anche il più piccolo errore! + +Se hai già battuto i tuoi appunti in LaTeX, non disperare, abbiamo realizzato un convertitore in grado di importare la tua dispensa. Per sapere come importare il tuo testo, [[Manual/Importing from LaTeX|leggi qui]]. + +Se stai cominciando per la prima volta a scrivere su WikiToLearn, ecco la nostra [[Manual|guida]]. + +== Fase 2: Coinvolgi il tuo gruppo == +Prendere appunti da solo dopo un po’ è noioso! Crea dei gruppi con i tuoi amici e provate ad organizzarvi per prendere insieme gli appunti di un corso. + +Una strategia che spesso funziona è quella di trovare 3/4 amici e dividersi le lezioni in base al calendario, scrivendole e rivedendole a turno. Con meno di due ore a settimana avrete una bellissima copia delle lezioni, migliore di un libro di testo, e ottimizzerete il vostro tempo studio. + +== Fase 3: Spargi la voce == +Non è finita qui! Sei un rappresentante? Fai parte di un’associazione studentesca? +Parlane agli altri studenti! Sarai sorpreso di quanti tra loro non vedevano l’ora di trovare qualcosa come WikiToLearn. Poniti come punto di riferimento mostrando come si lavora su wiki e prima di quanto tu creda avrai dato il via al gruppo della tua università. +Introduci WikiToLearn anche ai tuoi professori che potranno migliorare i tuoi appunti e pubblicare le loro dispense. +Sarà un guadagno per te e per gli altri!