README.md

La "piscine", dont le nom est inspiré de certaines pratiques dans les écoles
d'informatique, se veut une sorte d'atelier collectif ou chacun est autonome et
plonge sur les sujets de son choix, individuellement ou en petits groupes.

Nous vous proposons un <a href="../../tree/master">ensemble de plongeons</a> :
des tutoriels courts (15 à 20 minutes), auto-suffisants, nécessitant le moins
d'installation possible, notamment en s'appuyant sur des images Docker ou
VirtualBox. 

Vous êtes libre d'essayer les plongeons de votre choix, à votre rythme.

# Contribuer aux plongeons

Nous cherchons à élargir au maximum le champ des propositions
et des technologies. Si vous avez un sujet qui vous tient à coeur ou qui
vous semble important, n'hésitez pas à contribuer. Il ne s'agit pas d'écrire
un document d'expert, mais d'aider vos collègues à se mettre à l'eau.

# Préparation aux plongeons

## Instructions générales

Les tutoriels que nous vous proposons devront être exécutés sur vos ordinateurs
portables, par le biais d'images Docker ou de machines virtuelles VirtualBox.

Pour cette raison, nous vous demandons d'installer et de vous familiariser
avec Docker et VirtualBox, avant d'essayer les autres plongeons.

Vous veillerez à avoir une quantité raisonnable d'espace libre sur vos
ordinateurs portables, car les machines virtuelles sont gourmandes...

## Installation Docker

Vous trouverez dans les liens ci-dessous des mini-plongeons dédiés aux
différents systèmes d'exploitation.
* [Installer Docker sous Linux](MaitresNageurs/PiscineJI/blob/master/DockerLinux/README.md)
* [Installer Docker sous MacOSX](MaitresNageurs/PiscineJI/blob/master/DockerMac/README.md)
* [Installer Docker sous Windows](MaitresNageurs/PiscineJI/blob/master/DockerWindows/README.md)
* [Installer Docker sur du vieux matériel Apple](MaitresNageurs/PiscineJI/blob/master/DockerMacOld/README.md)

## Installation VirtualBox

C'est [ici](https://www.virtualbox.org/).

Si vous avez une version ancienne de VirtualBox, merci de la mettre à
jour, sous peine de conflit avec Docker.

Les utilisateurs de clavier azerty peuvent peiner à faire reconnaitre leur clavier.
Quelques trucs et astuces :
* essayez la commande `loadkeys fr` ; si elle est absente, essayez d'installer le package `kbd`.
* si vous avez lancé votre machine virtuelle en mode graphique et qu'elle
comprend un serveur X11, vous pouvez aussi tenter `setxkbmap fr`.
* sur MacOSX, c'est encore pire... si votre `alt` de gauche ne fonctionne pas,
parfois celui de droite fonctionne.