Comprendre et utiliser les repositories comme espaces structurés pour documenter, versionner et réutiliser des artefacts
Fondamentaux
Comprendre les repositories – fondamentaux pour PME
Comprendre ce qu’est un repository, à quoi il sert et quand il est utile en PME. Distinguer repository, DMS, wiki, espace collaboratif et simple dossier partagé, sans entrer dans la technique avancée.
MODCODE: MODTECREP001
Durée indicative : 1 heure
Pré-requis : Aucun
À l’issue du module, le participant est capable de :
- Expliquer ce qu’est un repository avec des mots simples.
- Identifier à quoi sert un repository dans un contexte PME.
- Distinguer repository, DMS, wiki, espace collaboratif et dossier partagé.
- Reconnaître les situations où un repository apporte de la valeur.
- Identifier les erreurs fréquentes liées à l’usage de repositories.
- Appliquer quelques règles simples pour lire ou organiser un repository sans entrer dans la technique avancée.
GitHub comme plateforme de recherche et d’apprentissage pour PME
Comprendre comment utiliser GitHub comme source d’apprentissage, d’inspiration et de recherche professionnelle. Savoir repérer des exemples, documentations, modèles et ressources utiles, tout en évaluant leur qualité, leur contexte et leurs limites.
MODCODE: MODTECREP002
Durée indicative : 1.5 heure
Pré-requis : MODTECREP001
À l’issue du module, le participant est capable de :
- Expliquer pourquoi GitHub peut être utilisé comme source de recherche et d’apprentissage, pas seulement comme plateforme technique.
- Identifier les types de ressources que l’on peut chercher dans des repositories publics.
- Lire les éléments de base d’un repository pour comprendre son objectif, son contexte et son niveau de maturité.
- Distinguer inspiration, exemple réutilisable, documentation, modèle et solution prête à l’emploi.
- Évaluer prudemment la qualité, le contexte et les limites d’une ressource trouvée.
- Appliquer une démarche simple pour transformer une découverte GitHub en apprentissage utile pour une PME.
Repository vs DMS, wiki et SharePoint – où mettre quoi ?
Choisir le bon espace selon le type d’information : document officiel, savoir vivant, modèle, code, prompt, exemple ou artefact technique. Réduire la confusion entre DMS, wiki, repository et collaboration quotidienne.
MODCODE: MODTECREP003
Durée indicative : 1.5 heure
Pré-requis : MODTECREP001 + MODTECCOL002
À l’issue du module, le participant est capable de :
- Expliquer pourquoi tous les contenus numériques ne doivent pas être stockés au même endroit.
- Distinguer les usages principaux d’un DMS, d’un wiki, d’un espace collaboratif, d’un repository et d’un simple dossier partagé.
- Identifier le bon espace selon le type d’information : document officiel, savoir vivant, modèle, code, prompt, exemple ou artefact technique.
- Repérer les risques liés à la dispersion, aux doublons et aux mauvais emplacements.
- Appliquer une grille simple de décision “où mettre quoi ?” adaptée à une PME.
- Proposer une première règle MVG pour réduire la confusion entre espaces numériques.
Mise en œuvre
README & Markdown – rédiger simplement une documentation technique
Créer une documentation courte, claire et maintenable avec README, structure simple, exemples et règles de mise à jour. Apprendre à documenter un artefact pour qu’il soit compris et réutilisé.
MODCODE: MODTECREP004
Durée indicative : 2 heures
Pré-requis : MODTECREP001
À l’issue du module, le participant est capable de :
- Expliquer le rôle d’un README dans un repository ou un ensemble d’artefacts numériques.
- Distinguer un README, une documentation longue, une note de travail, une procédure et une fiche de référence.
- Identifier les informations minimales à inclure pour qu’un artefact soit compris, utilisé et maintenu.
- Utiliser une structure simple de documentation avec titres, sections, listes, exemples et règles de mise à jour.
- Appliquer les bases de Markdown pour rédiger une documentation lisible et maintenable.
- Produire un premier README court pour un artefact PME : modèle, prompt, script, support, exemple ou dossier structuré.
GitHub comme plateforme d’assets et de versions pour ses propres artefacts de projet
Utiliser une logique de repository pour structurer, versionner et documenter des artefacts de projet : modèles, prompts, documentation technique, exemples et supports réutilisables. Créer une petite structure avec README et règles simples.
MODCODE: MODTECREP005
Durée indicative : 2 heures
Pré-requis : MODTECREP002 + MODTECREP004
À l’issue du module, le participant est capable de :
- Expliquer pourquoi certains artefacts de projet gagnent à être structurés dans une logique de repository.
- Distinguer un repository d’assets, un dossier partagé, une base de savoir, un DMS et un espace collaboratif.
- Identifier les artefacts de projet qui méritent d’être versionnés, documentés et maintenus.
- Concevoir une petite structure de repository adaptée à une PME.
- Appliquer des règles simples de version, nommage, README, revue et retrait.
- Créer un premier canevas de repository pour modèles, prompts, exemples, supports ou documentation technique.
Structure de repository pour artefacts de conseil, QMS et formation
Concevoir une structure simple pour des artefacts non purement techniques : modèles de conseil, supports de formation, éléments QMS, prompts, exemples et notes. Définir dossiers, conventions et règles de maintien.
MODCODE: MODTECREP006
Durée indicative : 2 heures
Pré-requis : MODTECREP001 + MODADMDMS006
À l’issue du module, le participant est capable de :
- Expliquer pourquoi des artefacts non techniques peuvent bénéficier d’une logique repository.
- Identifier les artefacts de conseil, QMS et formation qui doivent être structurés, documentés et maintenus.
- Distinguer une structure de repository d’une arborescence documentaire classique.
- Concevoir une structure simple de repository adaptée à des artefacts non purement techniques.
- Définir des conventions minimales : dossiers, nommage, README, statut, version, responsable et revue.
- Construire un premier canevas de repository pour un cas PME concret.
Issues, discussions et tableaux simples pour équipes non techniques
Utiliser des mécanismes simples de suivi : demandes, problèmes, idées, décisions et corrections. Montrer comment rendre le travail visible sans transformer le repository en outil de projet lourd.
MODCODE: MODTECREP007
Durée indicative : 1,5 heures
Pré-requis : MODTECREP001
À l’issue du module, le participant est capable de :
- Expliquer le rôle d’un suivi léger autour d’un repository ou d’un ensemble d’artefacts.
- Distinguer une issue, une discussion, une décision, une idée, une correction et une tâche.
- Identifier les situations où un tableau simple apporte de la visibilité sans lourdeur.
- Structurer un suivi minimal pour demandes, problèmes, idées et corrections.
- Définir des règles simples de statut, responsabilité, priorité et clôture.
- Construire un premier tableau de suivi adapté à une équipe non technique.
GitHub Issues pour des artefacts non techniques
Utiliser GitHub Issues comme mécanisme concret de suivi pour des artefacts non techniques : modèles, prompts, supports, checklists, documentation, exemples et assets PME. Structurer demandes, corrections, idées, décisions et revues sans transformer le repository en outil projet lourd.
MODCODE: MODTECREP011
Durée indicative : 1,5 heures
Pré-requis : MODTECREP001 + MODTECREP007
À l’issue du module, le participant est capable de :
- Expliquer à quoi sert GitHub Issues pour suivre des artefacts non techniques.
- Distinguer une issue de correction, une demande, une idée, une décision et une revue.
- Créer une structure simple d’issue compréhensible par une équipe non technique.
- Utiliser des labels, statuts et responsables sans complexité excessive.
- Définir une règle de clôture et de revue des issues.
- Appliquer GitHub Issues à des artefacts PME : modèles, prompts, README, supports, checklists ou exemples.
- Éviter les dérives : trop d’issues, pas de responsable, discussions sans clôture, doublons et backlog mort.
Pilotage & conformité
Utiliser des exemples open source en toute sécurité – qualité, contexte et risques
Apprendre à utiliser des exemples publics avec prudence : contexte, actualité, fiabilité, sécurité, dépendances et limites. Rester non juridique, mais développer les bons réflexes avant réutilisation.
MODCODE: MODTECREP009
Durée indicative : 1,5 heures
Pré-requis : MODTECREP001 + MODSECINF001
À l’issue du module, le participant est capable de :
- Expliquer pourquoi un exemple open source ou public ne doit pas être réutilisé sans vérification.
- Distinguer apprendre, s’inspirer, copier, adapter et réutiliser.
- Identifier les signaux simples de qualité, de contexte, de maintenance et de risque.
- Appliquer une checklist MVG avant de réutiliser un exemple public.
- Reconnaître les cas où une validation technique, sécurité ou juridique est nécessaire.
- Décider si un exemple peut être utilisé, adapté, documenté, ou écarté.
Gouvernance légère des repositories en PME
Définir des règles minimales pour maintenir des repositories utiles : responsabilités, droits, conventions, revue, archivage, sécurité et retrait des contenus obsolètes. Garder une approche pragmatique et proportionnée.
MODCODE: MODTECREP010
Durée indicative : 1,5 heures
Pré-requis : MODTECREP001 + MODTECREP005 + MODTECCOL001 + MODTECCOL007
À l’issue du module, le participant est capable de :
- Expliquer ce qu’est une gouvernance légère de repository dans un contexte PME.
- Identifier les risques liés à un repository non maintenu : confusion, obsolescence, droits trop larges, conventions non respectées, perte de contexte.
- Distinguer responsabilités, droits, conventions, revue, archivage, sécurité et retrait.
- Appliquer une approche MVG pour définir quelques règles minimales de maintien.
- Construire une première mini‑charte de gouvernance pour un repository d’artefacts.
- Décider quand maintenir, archiver, corriger, restreindre ou retirer un contenu.
Futur & innovation
Bibliothèque de prompts et d’assets IA avec une logique de repository
Structurer, versionner et documenter des prompts, exemples, consignes et artefacts IA. Définir une logique simple de test, validation, mise à jour et retrait des éléments obsolètes.
MODCODE: MODTECREP008
Durée indicative : 2 heures
Pré-requis : MODTECAIR007 + MODTECREP004
À l’issue du module, le participant est capable de :
- Expliquer pourquoi les prompts et artefacts IA utiles doivent être structurés, documentés et maintenus.
- Distinguer un prompt isolé, un prompt réutilisable, un exemple, une consigne, un résultat IA et un asset IA.
- Identifier quels prompts ou artefacts IA méritent d’être conservés dans une bibliothèque.
- Concevoir une structure simple de repository pour prompts et assets IA.
- Définir des règles minimales de documentation : objectif, contexte, usage, limites, validation, version et responsable.
- Appliquer une logique de test, revue, mise à jour, retrait et archivage des prompts obsolètes.