Documenter

La documentation est un pilier essentiel de tout projet open source. En contribuant vous permettez de rendre la plateforme plus facile d'accès. Merci à vous 👍.

Discussions autour de la documentation : communecter.org/#codocwiki (rejoignez la messagerie)

Il est important de documenter vos méthodes afin que d'autres personnes puissent s'en emparer. Sinon vous serez seul à faire certaines tâches, et on sera bien embêté en votre absence.

Participer au wiki

Édition

Une simple inscription suffit pour créer ou modifier des pages. Pour pouvoir créer ou modifier des chapitres ou des livres demandez le statut d'éditeur dans la messagerie des rédacteurs.

N'ayez pas peur de faire un brouillon : vous ou quelqu'un d'autre pourra venir compléter plus tard. Il y a un historique de version pour revenir en arrière, et il est possible de renommer et déplacer les pages sans problèmes (les redirections sont gérées).

Contenu

Tout ce qui concerne le projet COmmunecter est pertinent a documenter. Ça va de la manière dont nous discutons, au code source en passant par la gouvernance et la communication.

Aujourd'hui nous avons 4 thématiques principales, mais ça peut être amener à évoluer :
Capture-d’écran_2019-01-04_11-15-16.png

Organisation

Le logiciel BookStack structure la documentation en pages, chapitres, livres et étagères. Un chapitre est un ensemble de pages et les étagères un ensemble de livres.

Par exemple, dans l'étagère COmmunecter il y a le livre "Utiliser l'outil", et au chapitre des fonctionnalités on peut lire la page sur le moteur de recherche.Capture-d’écran_2019-01-04_10-40-41.png

Traduction

Les traductions de pages ne sont pas gérées mais un ticket est ouvert à ce sujet. En attendant nous pourrions créer une étagère "Français" et "English" et mettre des liens sur chacune des pages pour renvoyer vers la traduction associée. Toute contribution est la bienvenue.

Intégration de Google Slides

  1. Obtenir le code : Fichier > Publier sur le web > Intégrer > Indiquez une taille personnalisée de 830px de large > Publier
  2. Intégrer au wiki : Insert/edit media > Embeb > Collez le code > OKCapture-d’écran_2019-10-22_09-30-41.pngPeek-22-10-2019-09-25.gif

Enregistrer une visioconférence

La liste de nos visioconférences est ici.

OBS Studio

Si vous n'intervenez pas ou peu (sinon regardez cette vidéo pour séparer les voix) :

  1. Téléchargez et installez OBS
  2. Ajoutez une Capture de la fenêtre dans les sources en bas à gauche
  3. Dans mixage audio : réduire Mic/Aux et ajustez l'Audio du bureau
  4. Démarrer l'enregistrement en bas à gauche

Faites un test de quelques secondes au début de la visioconférence pour tester votre configuration.

Si vous avez le temps et l'envie de le faire vous pouvez ajouter un fond, des logos, textes, images, ...vlcsnap-2018-11-21-12h18m10s174.png

Google Hangout

Nous essayons de nous dégoogliser un maximum, mais il arrive que nous utilisions Google Hangout lorsque les alternatives à Google dysfonctionnent, ou que l'on dépasse le nombre maximum de participant·e·s et/ou lorsque l'interlocuteur nous impose cet outil.

Pour que votre conférence soit directement publiée sur Youtube il faut programmer un Hangouts en direct : méthode.

Enregistrer une capture d'écran

Tutoriels : Windows, Linux et Mac.

Certains logiciels vous permettent de générer des gifs à partir de ce que vous voyez sur votre écran : Peek (linux).