diff --git a/docs/alpinux/installparty-benevole.md b/docs/alpinux/installparty-benevole.md new file mode 100644 index 0000000..f8d6ddd --- /dev/null +++ b/docs/alpinux/installparty-benevole.md @@ -0,0 +1,113 @@ +--- +description: Pour les bénévoles installateurs d'Alpinux : retrouver ses accès, annoncer ses heures de présence, préparer les machines et répondre aux participants. +--- + +# 🔧 J'aide comme bénévole installateur + +Cette page est pour l'équipe qui installe. Les autres usages du site ont +[leur propre page](installparty-mode-emploi.md). + +--- + +## Retrouver ses accès + +![L'écran où l'on donne son adresse](../assets/installparty/03-espace-connexion.png) + +[installparty.alpinux.org/party/moi](https://installparty.alpinux.org/party/moi) +est le seul endroit où l'on saisit son adresse. Vous y recevez un lien — valable +une demi-heure — qui ouvre tout ce que cette adresse ouvre. + +![L'espace personnel : ce que votre adresse ouvre](../assets/installparty/04-espace-personnel.png) + +On y trouve son **code installateur**, les machines dont on s'occupe, et le lien +vers sa grille. + +## Entrer dans son espace : deux codes + +![L'écran qui demande le code à quatre chiffres](../assets/installparty/07-deux-codes.png) + +- **Le code installateur**, quatre caractères, donné par l'organisation ; +- **un code à quatre chiffres**, que vous choisissez. + +Le premier se dicte au téléphone, donc il se devine ; le second le protège. + +### À votre première venue + +Saisissez votre code installateur et laissez le second champ vide : un lien part +vers votre boîte et vous fait choisir vos quatre chiffres. + +![Le choix du code à quatre chiffres](../assets/installparty/08-choisir-son-code.png) + +Le lien vaut une demi-heure. Oublié votre code ? Demandez-en un autre depuis la +page de connexion — le nouveau remplace l'ancien. + +!!! tip "Faites-le avant le jour J" + Le choix du code passe par votre boîte aux lettres. Le faire tranquillement + chez soi vaut mieux que de s'y prendre en salle, un samedi matin. + +## Annoncer ses heures + +![La grille des heures de présence et les rendez-vous du jour](../assets/installparty/05-espace-installateur.png) + +!!! warning "Vos heures ouvrent les places" + Le nombre de créneaux proposés au public **se calcule à partir des heures + annoncées**. Une grille vide n'ouvre aucune place : ce n'est pas une + formalité, c'est ce qui décide du nombre de personnes qu'on pourra recevoir. + +Cochez les heures où vous serez là. L'enregistrement est automatique, et vous +pouvez y revenir autant de fois que votre journée change — l'organisation le +voit aussitôt. + +Le tableau **« Où en est la journée ? »** montre, heure par heure, combien +d'installateurs sont annoncés, combien seront occupés et combien restent +disponibles. Une colonne dégarnie se comble en cochant une heure de plus. + +## Préparer les installations + +Sous les rendez-vous du jour, vous voyez qui vient, avec quelle machine et ce que +la personne a signalé — **sans ses coordonnées** : s'il faut joindre quelqu'un, +c'est l'organisation qui s'en charge. + +Vous pouvez : + +- **écrire ce qu'il y a à prévoir** dans la note « À prévoir avant + l'installation » : un dongle, un pilote, un point à vérifier ; +- **vous charger d'une machine**, pour que l'équipe sache qui s'en occupe. Votre + nom s'affiche alors à côté du rendez-vous ; +- **répondre** aux questions du participant, et joindre un document ou une photo. + +!!! danger "La personne inscrite lit cette note" + « À prévoir avant l'installation » s'affiche sur sa fiche, sous le titre + « Informations importantes », et un message l'avertit le soir même. + Écrivez-la comme si elle la lisait, parce qu'elle la lira. + +Les versions précédentes de la note restent consultables, avec leur auteur : on +peut voir ce qui a été modifié, et reprendre une version antérieure si besoin. + +## Le jour de l'install party + +La **fiche d'installation** — les points à cocher — s'ouvre le jour même. D'ici +là, il n'y a rien à y noter. + +Pour l'ouvrir, deux chemins : depuis votre espace si vous vous êtes déjà chargé +de la machine, ou en donnant le **numéro de réservation** que la personne annonce +à l'accueil. + +--- + +## Questions courantes + +??? question "Je me suis inscrit par un lien, et je ne vois aucun rendez-vous" + Votre inscription attend d'être confirmée par l'équipe. En attendant, vous + pouvez cocher vos heures — c'est même le plus utile. Vous recevrez un message + quand ce sera fait. + +??? question "Je me suis trompé plusieurs fois de code" + Au bout de quelques essais, l'accès se ferme quelques minutes. Cela ne + concerne que vous : vos collègues, même sur le même réseau, ne sont pas + gênés. + +??? question "Puis-je laisser une machine à quelqu'un d'autre ?" + Oui, tant que vous n'avez rien écrit sur sa fiche : le bouton « Je ne m'en + occupe plus » la rend disponible. Une fois que vous y avez noté quelque + chose, votre nom y reste — une fiche doit pouvoir dire qui l'a remplie. diff --git a/docs/alpinux/installparty-mode-emploi.md b/docs/alpinux/installparty-mode-emploi.md index cdc087b..776ef66 100644 --- a/docs/alpinux/installparty-mode-emploi.md +++ b/docs/alpinux/installparty-mode-emploi.md @@ -1,17 +1,14 @@ --- -description: Comment s'inscrire à une install party, suivre la fiche de sa machine, et pour les bénévoles installateurs, annoncer ses heures et préparer ses installations. +description: Le mode d'emploi du site des install parties d'Alpinux, selon que vous venez faire installer Linux, que vous aidez comme bénévole ou que vous organisez la journée. --- -# 🐧 Le site des install parties, mode d'emploi +# 🐧 Le site des install parties Les install parties d'Alpinux se tiennent avec un outil à nous : **[installparty.alpinux.org](https://installparty.alpinux.org)**. On y réserve son créneau, on y suit ce qui a été fait sur sa machine, et les bénévoles y préparent leur journée. -Cette page explique les trois usages. Elle répond sans doute à votre question — -sinon, écrivez-nous à secretaire@alpinux.org. - !!! info "Pas de compte, pas de mot de passe" Il n'y a rien à créer et rien à retenir. Tout passe par des liens reçus par courriel et, pour les bénévoles, par un code personnel. Une adresse donnée @@ -19,141 +16,32 @@ sinon, écrivez-nous à secretaire@alpinux.org. --- -## Je veux faire installer Linux +## Trois façons d'utiliser le site -### 1. Choisir son créneau +### 💻 [Je viens faire installer Linux](installparty-participant.md) -Depuis [installparty.alpinux.org](https://installparty.alpinux.org), vous arrivez -sur la liste des install parties à venir. +Choisir son créneau, s'inscrire, et suivre la fiche de sa machine avant, pendant +et après l'install party. Vous pouvez aussi y écrire aux bénévoles. -![La liste des install parties ouvertes aux inscriptions](../assets/installparty/01-liste-publique.png) +### 🔧 [J'aide comme bénévole installateur](installparty-benevole.md) -Chaque carte indique la date, le lieu et s'il reste de la place. Un clic sur -**S'inscrire** ouvre le formulaire. +Retrouver ses accès, annoncer ses heures de présence — ce sont elles qui ouvrent +les places —, préparer les machines qu'on prendra et répondre aux questions. -### 2. S'inscrire +### 📋 [J'organise une install party](installparty-organisateur.md) -![Le formulaire d'inscription, avec le choix de l'heure](../assets/installparty/02-inscription.png) +Tenir la journée : horaires, places, équipe, fiches. Et ce qu'il faut savoir sur +les liens d'accès, qui valent mot de passe. -Ce qu'on vous demande, et pourquoi : +--- -| Ce qu'on demande | À quoi cela sert | +## Où trouver quoi + +| Vous cherchez | Adresse | |---|---| -| Votre nom | vous accueillir, et retrouver votre machine dans la journée | -| Votre adresse électronique | vous envoyer votre confirmation et le suivi | -| Votre téléphone | vous joindre le jour même si besoin — facultatif | -| La machine et son âge | préparer ce qu'il faut : une clé, un pilote, un adaptateur | -| Ce que vous signalez | tout ce que vous jugez utile : un bruit, une lenteur, un doute | -| L'heure de passage | les créneaux restants s'affichent seuls | +| La prochaine install party, et s'y inscrire | [installparty.alpinux.org](https://installparty.alpinux.org) | +| Vos accès : code installateur, liens, inscriptions | [/party/moi](https://installparty.alpinux.org/party/moi) | +| La fiche de votre machine | le lien personnel reçu à l'inscription | -Deux cases sont à cocher : **vos sauvegardes sont faites** et vous avez lu la -décharge. La première n'est pas une formalité — une installation efface le -disque. - -### 3. Après l'inscription - -Vous recevez un courriel avec : - -- **votre numéro de réservation**, à annoncer à l'accueil le jour J ; -- **un lien personnel** vers la fiche de votre machine. Gardez-le. - -### 4. Suivre la fiche de sa machine - -![La fiche d'installation vue par le participant](../assets/installparty/06-fiche-participant.png) - -Cette page vit avant, pendant et après l'install party. - -**Avant**, les bénévoles y notent ce qu'il faudra prévoir pour votre machine — -sous « Informations importantes ». Lisez-le : on vous y demande parfois -d'apporter un câble ou de retrouver un mot de passe. - -**Vous pouvez leur répondre** : le bloc « Répondre », en bas de la page, envoie -votre message aux bénévoles qui préparent votre passage. Vous pouvez y joindre -une photo ou une capture d'écran — un message d'erreur se montre mieux qu'il ne -se décrit. Ne répondez pas au courriel : il ne leur parviendrait pas. - -**Pendant**, la fiche se remplit au fur et à mesure. **Après**, elle reste -consultable : c'est le compte rendu de ce qui a été fait. - -Un message vous prévient le soir quand quelque chose a changé. - -!!! question "Lien perdu ?" - Rendez-vous sur [installparty.alpinux.org/party/moi](https://installparty.alpinux.org/party/moi), - donnez l'adresse avec laquelle vous vous êtes inscrit, et tout ce que cette - adresse ouvre vous est renvoyé. - ---- - -## Je suis bénévole installateur - -### Retrouver ses accès - -![L'écran où l'on donne son adresse](../assets/installparty/03-espace-connexion.png) - -[installparty.alpinux.org/party/moi](https://installparty.alpinux.org/party/moi) -est le seul endroit où l'on saisit son adresse. Vous y recevez un lien — valable -une demi-heure — qui ouvre tout ce que cette adresse ouvre. - -![L'espace personnel : ce que votre adresse ouvre](../assets/installparty/04-espace-personnel.png) - -On y trouve son **code installateur**, les machines dont on s'occupe, et le -lien vers sa grille. - -### Annoncer ses heures - -![La grille des heures de présence et les rendez-vous du jour](../assets/installparty/05-espace-installateur.png) - -!!! warning "Vos heures ouvrent les places" - Le nombre de créneaux proposés au public **se calcule à partir des heures - annoncées**. Une grille vide n'ouvre aucune place : ce n'est pas une - formalité, c'est ce qui décide du nombre de personnes qu'on pourra recevoir. - -Cochez les heures où vous serez là. L'enregistrement est automatique, et vous -pouvez y revenir autant de fois que votre journée change. - -### Deux codes pour entrer - -- **Le code installateur**, quatre caractères, donné par l'organisation ; -- **un code à quatre chiffres**, que vous choisissez. - -À votre première venue, laissez le second vide : un lien part vers votre boîte -et vous fait le choisir. Oublié ? Demandez-en un autre depuis la même page. - -### Préparer les installations - -Sous les rendez-vous du jour, vous voyez qui vient, avec quelle machine et ce -que la personne a signalé. Vous pouvez : - -- **écrire ce qu'il y a à prévoir** — un dongle, un pilote, un point à - vérifier. Cette note est lue par la personne inscrite : écrivez-la comme si - elle la lisait, parce qu'elle la lira ; -- **vous charger d'une machine**, pour que l'équipe sache qui s'en occupe ; -- **répondre** aux questions du participant, et joindre un document. - -La fiche à cocher, elle, s'ouvre le jour de l'install party. - -!!! note "Votre inscription est confirmée par l'équipe" - Si vous vous êtes inscrit par un lien, vous pourrez cocher vos heures tout - de suite, mais vous ne verrez les rendez-vous qu'une fois votre inscription - confirmée. Vous recevrez un message à ce moment-là. - ---- - -## J'organise une install party - -L'espace d'organisation tient la journée : horaires, places, équipe, fiches, -check-list. Son lien **vaut mot de passe** et cesse de valoir trente minutes -après la dernière action — on le redemande depuis -[/party/moi](https://installparty.alpinux.org/party/moi). - -Quelques règles à connaître : - -- **Les coordonnées des inscrits ne s'affichent pas d'elles-mêmes.** Un bouton - les demande, et chaque demande est inscrite au journal de l'install party. -- **Le nombre de places se calcule**, il ne se saisit pas : il découle des - heures annoncées par les installateurs et de la charge que vous fixez. -- **Ne publiez jamais un lien contenant `key=`** : voir - [Liens et codes QR](../communication/liens-et-codes-qr.md). - -Pour ouvrir une install party, votre adresse doit y être autorisée : demandez à -secretaire@alpinux.org. +Une question à laquelle ces pages ne répondent pas ? Écrivez-nous — l'adresse +figure au bas des messages que vous recevez. diff --git a/docs/alpinux/installparty-organisateur.md b/docs/alpinux/installparty-organisateur.md new file mode 100644 index 0000000..3828bc3 --- /dev/null +++ b/docs/alpinux/installparty-organisateur.md @@ -0,0 +1,107 @@ +--- +description: Pour les organisateurs d'une install party Alpinux : tenir la journée, gérer l'équipe et les créneaux, et les règles à connaître sur les liens d'accès. +--- + +# 📋 J'organise une install party + +Cette page est pour qui tient une install party de bout en bout. Les autres +usages du site ont [leur propre page](installparty-mode-emploi.md). + +--- + +## L'espace d'organisation + +![L'espace d'organisation : horaires, places, équipe](../assets/installparty/09-organisation.png) + +Tout s'y tient : les horaires et leurs places, l'équipe et ses heures, les +inscrits et leurs fiches, la check-list. + +!!! danger "Le lien vaut mot de passe" + L'adresse de cette page contient une clé. Quiconque l'a peut voir les + inscrits, les modifier et les supprimer. + + - Ne la publiez **jamais** : ni sur une affiche, ni dans un code QR, ni dans + un message à plusieurs. Voir + [Liens et codes QR](../communication/liens-et-codes-qr.md). + - Elle **cesse de valoir trente minutes** après votre dernière action. On en + redemande une depuis [/party/moi](https://installparty.alpinux.org/party/moi), + ce qui remplace l'ancienne. + +## Les places se calculent + +Le nombre de places d'un créneau n'est pas saisi : il se **déduit** des +installateurs annoncés présents pendant toute la durée d'une installation, +pondérés par la charge que vous fixez. + +- Huit installateurs présents, charge à 90 % : sept places. +- Baisser la charge garde de la marge — le temps d'accueillir, de dépanner un + voisin, de souffler. +- Vous pouvez ajouter ou retirer une place à la main ; l'écart est conservé même + si l'équipe change. + +Une conséquence : **relancer les installateurs qui n'ont pas coché leurs heures +ouvre des places**. Le bouton est sur la page, à côté de ceux qui manquent. + +## L'équipe + +Deux façons d'entrer dans l'équipe : + +- **vous ajoutez quelqu'un** : il reçoit son code, et voit tout aussitôt ; +- **quelqu'un s'inscrit** par le lien d'inscription des installateurs : il + attend votre confirmation avant de voir les rendez-vous, et ses heures + n'ouvrent pas de place d'ici là. La page le signale par « inscrit lui-même · + à confirmer ». + +Cette différence est voulue : le lien d'inscription circule sur les listes de +diffusion, et s'inscrire ne doit pas suffire à voir chez qui l'on va installer. + +## Les coordonnées ne s'affichent pas + +L'adresse et le téléphone de chaque inscrit sont masqués. Un bouton les demande, +et **chaque demande est inscrite au journal**. + +![L'historique : ce qui a été fait, et depuis où](../assets/installparty/10-historique.png) + +La page **Historique** montre, pour votre install party : quand, quoi, sur qui, +depuis quelle adresse et avec quel navigateur. Elle sert à une chose — savoir ce +qui a été consulté si un accès venait à fuiter. + +Les adresses IP s'effacent d'elles-mêmes au bout de six mois. + +## Avant la journée + +- **Composer la check-list** que suivront les installateurs : un modèle existe, + à adapter. +- **Annoncer que les fiches sont prêtes** : un bouton prévient toute l'équipe + qu'elle peut préparer les machines. +- **Écrire ce qu'il y a à prévoir** sur les fiches que vous connaissez déjà — + ce que la personne a dit au téléphone, par exemple. +- **Vérifier l'écran de salle** : il affiche les rendez-vous à l'accueil, sans + aucune coordonnée. Sa clé est distincte de la vôtre, parce qu'un écran se + photographie. + +## Le jour même + +- Les participants annoncent leur **numéro de réservation** à l'accueil. +- Un rendez-vous peut être **déplacé** d'un créneau à l'autre : la personne et + les installateurs concernés en sont prévenus, et la fiche suit. +- Les fiches se remplissent ; vous pouvez les relire et les corriger. + +--- + +## Questions courantes + +??? question "J'ai perdu le lien de mon install party" + [/party/moi](https://installparty.alpinux.org/party/moi), avec l'adresse + enregistrée pour cette install party. Si personne ne l'a plus, écrivez à + l'association. + +??? question "Une clé a été publiée par erreur" + Renouvelez-la immédiatement en redemandant votre lien, puis regardez + l'Historique pour savoir ce qui a été consulté. La marche à suivre complète + est dans [Liens et codes QR](../communication/liens-et-codes-qr.md). + +??? question "Comment ouvrir une nouvelle install party ?" + Votre adresse doit y être autorisée. Depuis + [/party/moi](https://installparty.alpinux.org/party/moi), un bouton + « Ouvrir une install party » apparaît si c'est le cas. diff --git a/docs/alpinux/installparty-participant.md b/docs/alpinux/installparty-participant.md new file mode 100644 index 0000000..c6729ab --- /dev/null +++ b/docs/alpinux/installparty-participant.md @@ -0,0 +1,106 @@ +--- +description: S'inscrire à une install party Alpinux, comprendre ce qu'on vous demande, et suivre la fiche de votre machine avant, pendant et après la journée. +--- + +# 💻 Je viens faire installer Linux + +Cette page suit votre parcours, de l'inscription au compte rendu de +l'installation. Les autres usages du site ont +[leur propre page](installparty-mode-emploi.md). + +--- + +## 1. Choisir son créneau + +Depuis [installparty.alpinux.org](https://installparty.alpinux.org), vous arrivez +sur la liste des install parties à venir. + +![La liste des install parties ouvertes aux inscriptions](../assets/installparty/01-liste-publique.png) + +Chaque carte indique la date, le lieu et s'il reste de la place. Un clic sur +**S'inscrire** ouvre le formulaire. + +## 2. S'inscrire + +![Le formulaire d'inscription, avec le choix de l'heure](../assets/installparty/02-inscription.png) + +Ce qu'on vous demande, et pourquoi : + +| Ce qu'on demande | À quoi cela sert | +|---|---| +| Votre nom | vous accueillir, et retrouver votre machine dans la journée | +| Votre adresse électronique | vous envoyer votre confirmation et le suivi | +| Votre téléphone | vous joindre le jour même si besoin — facultatif | +| La machine et son âge | préparer ce qu'il faut : une clé, un pilote, un adaptateur | +| Ce que vous signalez | tout ce que vous jugez utile : un bruit, une lenteur, un doute | +| L'heure de passage | les créneaux restants s'affichent seuls | + +Deux cases sont à cocher : **vos sauvegardes sont faites** et vous avez lu la +décharge. + +!!! danger "Les sauvegardes ne sont pas une formalité" + Une installation efface le disque. Copiez vos documents, vos photos et vos + mots de passe sur un disque externe ou une clé **avant** de venir. Les + bénévoles vous aideront volontiers à le faire, mais cela prend du temps — + autant arriver prêt. + +## 3. Après l'inscription + +Vous recevez un courriel avec : + +- **votre numéro de réservation**, à annoncer à l'accueil le jour J ; +- **un lien personnel** vers la fiche de votre machine. Gardez-le : il reste + valable et c'est le seul moyen d'accéder à votre fiche. + +## 4. Suivre la fiche de sa machine + +![La fiche d'installation vue par le participant](../assets/installparty/06-fiche-participant.png) + +Cette page vit avant, pendant et après l'install party. + +**Avant**, les bénévoles y notent ce qu'il faudra prévoir pour votre machine — +sous « Informations importantes ». Lisez-le : on vous y demande parfois +d'apporter un câble, de retrouver un mot de passe ou de préciser un détail. + +**Pendant**, elle se remplit au fur et à mesure : ce qui a été vérifié, ce qui a +été installé, ce qui reste à faire. + +**Après**, elle reste consultable. C'est le compte rendu de ce qui a été fait sur +votre machine, et vous pouvez y revenir des mois plus tard. + +Un message vous prévient le soir quand quelque chose a changé. + +## 5. Écrire aux bénévoles + +Le bloc **« Répondre »**, en bas de votre fiche, envoie votre message aux +bénévoles qui préparent votre passage : un doute sur ce qu'on vous demande +d'apporter, une machine de plus, un empêchement. + +Vous pouvez y joindre une **photo ou une capture d'écran** — un message d'erreur +se montre mieux qu'il ne se décrit. + +!!! warning "Ne répondez pas au courriel" + Les messages que le site vous envoie partent d'une adresse automatique. + Une réponse n'atteindrait pas les bénévoles et se perdrait : utilisez le bloc + « Répondre » de votre fiche. + +--- + +## Questions courantes + +??? question "J'ai perdu le lien de ma fiche" + Rendez-vous sur [installparty.alpinux.org/party/moi](https://installparty.alpinux.org/party/moi), + donnez l'adresse avec laquelle vous vous êtes inscrit, et tout ce que cette + adresse ouvre vous est renvoyé — la fiche comprise. + +??? question "Je ne peux plus venir" + Dites-le nous : votre place sera rendue à quelqu'un d'autre, et vos + informations effacées si vous le souhaitez. L'adresse figure au bas des + messages que vous avez reçus. + +??? question "Qui voit mes coordonnées ?" + L'organisation, et seulement en les demandant — chaque consultation est + inscrite au journal de l'install party. Les bénévoles installateurs, eux, + voient votre nom, votre machine et ce que vous avez signalé, mais **ni votre + adresse ni votre téléphone**. Voir + [Vos données, vos adresses, nos envois](donnees-personnelles.md). diff --git a/docs/assets/installparty/07-deux-codes.png b/docs/assets/installparty/07-deux-codes.png new file mode 100644 index 0000000..75decbe Binary files /dev/null and b/docs/assets/installparty/07-deux-codes.png differ diff --git a/docs/assets/installparty/08-choisir-son-code.png b/docs/assets/installparty/08-choisir-son-code.png new file mode 100644 index 0000000..9ff1c65 Binary files /dev/null and b/docs/assets/installparty/08-choisir-son-code.png differ diff --git a/docs/assets/installparty/09-organisation.png b/docs/assets/installparty/09-organisation.png new file mode 100644 index 0000000..5554a62 Binary files /dev/null and b/docs/assets/installparty/09-organisation.png differ diff --git a/docs/assets/installparty/10-historique.png b/docs/assets/installparty/10-historique.png new file mode 100644 index 0000000..bb6a59d Binary files /dev/null and b/docs/assets/installparty/10-historique.png differ diff --git a/mkdocs.yml b/mkdocs.yml index 81fc2ff..7b839e5 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -82,7 +82,11 @@ nav: - alpinux/index.md - FAQ: alpinux/faq.md - Install Party: alpinux/install-party.md - - Le site des install parties, mode d'emploi: alpinux/installparty-mode-emploi.md + - Le site des install parties: + - alpinux/installparty-mode-emploi.md + - Je viens faire installer Linux: alpinux/installparty-participant.md + - J'aide comme bénévole: alpinux/installparty-benevole.md + - J'organise une install party: alpinux/installparty-organisateur.md - Présentations passées: alpinux/presentations.md - Événements & RDV: alpinux/evenements.md - Vos données, vos adresses, nos envois: alpinux/donnees-personnelles.md