---
Projet : Chemins de la Transition
Equipe : Embarquement
Contributeur : Karine Varaldo
Crédit : CC-BY
Version : 1
---
Réalisation d'un tutoriel pour faciliter la prise en main de github pour des non-spécialistes

# tuto-GitHub
## C'est quoi GitHub ?

Ayant démarré sous forme de plateforme collaborative pour développeurs (ceux qui écrivent du code pour élaborer des programmes informatiques), GitHub est désormais le plus grand espace de stockage de travaux collaboratifs dans le monde et fonctionne comme un grand réseau social mais aussi comme une plateforme de connaissance et de documentation.

Vous construisez un profil, vous y déposez des projets à partager et vous vous connectez avec d’autres utilisateurs en suivant leurs comptes. Lorsque vous accédez à leurs comptes, vous êtes libres de télécharger, étudier, commenter ou construire dessus tout ce que vous voulez sur ce qu’elles ajoutent sur ce réseau.

Même si la plupart des utilisateurs y déposent des projets de programmes ou de code, rien ne vous empêche d’y placer des textes ou tout type de fichier (des images, des documents...) à présenter dans vos répertoires de projets.

### Une petite video pour comprendre en 3 minutes

<iframe width="560" height="315" src="https://www.youtube.com/embed/w3jLJU7DT5E" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

## Découverte de l'interface
### Petit lexique en carte mentale
*clique droit sur l'image pour l'afficher en plus grand*

### Comment utiliser GitHub avec "les chemins de la transition"
1. **les différents repositories** correspondent aux grands chantiers en cours de l'association : explorer-les en cliquant dessus.
2. **Explorer les différentes issues** :
- ajouter des commentaires : cliquez sur l'issue qui vous intéresse, lisez le fil de discussion, ajoutez votre commentaire, envoyez le en cliquant sur "comment"
- faites de nouvelles propositions (NewIssue), enrichissez là en lui ajoutant un "label", attribuez là à quelqu'un de l'équipe "assignee"...
3. **Chaque réunion hebdo** du lundi sera l'occasion de passer en revue les différentes issues, de les cloturer ou de les résoudre

4. **Comment faire des dépots à distance ?**
- [ ] (CodiMD à github), (drive to GH)
- [ ] Local à Github (word, git...)

#### Une video qui montre les possibilités de travailler en mode projet avec GitHub
<iframe width="560" height="315" src="https://www.youtube.com/embed/nI5VdsVl0FM" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

## Corpus documentation
### Général

- [Github et Git pour les nuls](https://www.christopheducamp.com/2013/12/15/github-pour-nuls-partie-1/) (ou ceux qui ne savent pas coder), par Christophe Ducamp
- [Aide officielle en anglais](https://help.github.com/en)
- [Aide synthètisée en anglais](https://guides.github.com/)
- Le markdown, la synthaxe pour formater du texte sur GitHub : https://help.github.com/en/github/writing-on-github/basic-writing-and-formatting-syntax

### Pour aller plus loin
De videos
git et github, pour une utilisation en local et la découverte des lignes de commande, par la Bascule
<iframe width="560" height="315" src="https://www.youtube.com/embed/hPfgekYUKgk" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

### Des fonctionnalités à ajouter
- tableau blanc LeanBoard : à utiliser lors des réunions de réflexions
- GitHub Learning Lab : un tuto pas à pas pour apprendre à utiliser github
- Github ClassRoom : pour faire des cours en lignes
- GitHub Page : créer un site directement d'après les dépots https://pages.github.com/

---