L’autoéquipement dans la création d’une REL

                   

Christopher Fuhrman (christopher.fuhrman@etsmtl.ca)

École de technologie supérieure

Mouna Moumene (mouna.moumene@etsmtl.ca)

École de technologie supérieure

12 mai 2023

Contexte

Ressource Educative Libre (REL)
Manuel « Analyse et conception de logiciels (LOG210) »

Aperçu de la REL

Qu’est-ce que l’autoéquipement ?

  • Si une entreprise fabrique un produit, elle devrait l’utiliser elle-même plutôt que de simplement le vendre aux clients.
    • To eat your own dog food ou dogfooding.
    • Utilisation « interne » d’un produit.
    • Exemples : l’employé(e) Tesla conduit une Tesla, l’ingénieur(e) Google possède un téléphone Android, etc.
  • Objectif : améliorer le produit.

Entreprise « produits libres »

  • Produire du contenu libre avec des outils et des logiciels libres nous implante dans l’entreprise des produits libres.

  • Nous devons aussi ramener une valeur ajoutée et contribuer à leur amélioration.

  • Comment s’impliquer réellement dans le processus d’amélioration de ces outils ?

Expérience REL

Manuel de cours d’analyse et de conception de logiciels

Écosystème d’outils « logiciels libres »

Quarto Création de documentation (évolution de R Markdown)
Pandoc Convertisseur de formats, extensions pour supporter formats personnalisés
\(\LaTeX\) Préparation de documents scientifique (PDF)
PlantUML PlantUML Création de diagrammes
GitHub Gestion des versions et suivi des problèmes
VisualStudio Code VisualStudio Code Rédaction de Markdown, extension pour Quarto, intégration Git, etc.

Comment contribuer ?

  • Donner une rétroaction aux développeurs
    • Discussions dans un forum (GitHub)
    • Système de suivi de problèmes (GitHub)
  • Proposer des changements de documentation (GitHub)
  • 😣 Coder des corrections de bogues
  • 😣 Coder de nouvelles fonctionnalités

Exemple de Discussion (Quarto)

Exemple de Discussion (Quarto)

Exemple de correction de bogue rapide

  • quarto-dev/quarto-cli #4145
  • Erreur de référence croisée : « Annexe » plutôt que « Chapitre »
  • Bogue corrigé dans deux jours !

Correction de bogue dans 2 jours

Quarto : Communauté très active :

Conclusion1

La création d’une REL grâce aux logiciels libres est aussi l’occasion de contribuer à la communauté de logiciels libres.

Manuel écrit dans Quarto (Markdown)

Markdown est un langage de balisage léger lightweight markup language

::: hanging-indent

**Ce manuel** a été utilisé dans le 
cadre du cours *Analyse et conception 
de logiciels (LOG210)* à l'École de 
technologie supérieure (ÉTS).

:::

Ce manuel a été utilisé dans le cadre du cours Analyse et conception de logiciels (LOG210) à l’École de technologie supérieure (ÉTS).

Avantages : Facilité, portabilité, lisibilité, rapidité
Inconvénients : Limitation de formatage, de personnalisation, dépendance sur la syntaxe

Copyright 2023 © Christopher Fuhrman, École de technologie supérieure

Notes de bas de page

  1. volunteering (CC BY) par Rusmaniah de Noun Project