Les éléments d'un portfolio

Ce que vous saurez faire

Planifiez des projets qui montrent vos compétences, sous une forme qu’une personne pressée peut examiner en quelques minutes. Un petit projet clair et honnête vaut plus qu’un grand projet que personne ne comprend.

Avant de commencerCe qu’il faut savoir et avoir sous la mainEnviron 35 minutes

Ce que vous devez savoir

• Vous avez terminé le module 4.
• Le cadrage, la référence de base, l’évaluation et le coût des erreurs, vus dans Cadrer le problème : quatre questions pour cadrer un problème et De la référence de base au déploiement : étape 1 : la référence de base.

Ce qu’il vous faut

• Votre plan de huit semaines et son livrable, sous ## Eight-week plan (plan de huit semaines) dans notes.md, tirés de Gérer les outils et les coûts : exercice guidé : votre plan de départ de huit semaines.
• Votre inventaire avec preuves, sous ## Inventory with evidence (inventaire avec preuves), tiré de Des preuves plutôt qu’une autoévaluation : exercice guidé : mettez à jour votre inventaire. Chaque fiche de projet nomme des compétences de cet inventaire.
• Votre fiche de projet, sous ## Project brief (fiche de projet), tirée de L’équipe et le contexte d’affaires : exercice guidé : rédiger une fiche de projet, sera utile ici.

À quoi sert un portfolio

Un portfolio est une petite collection de vos travaux que d’autres personnes peuvent consulter, généralement de deux à quatre projets. Son rôle est simple : fournir des preuves des compétences que vous affirmez avoir.

La personne qui examine votre travail, par exemple un responsable du recrutement, consacre souvent seulement quelques minutes à chaque projet. Pendant ce temps, elle se demande :

1. Quel problème ce projet résout-il, et pour qui?
2. Est-ce qu’il fonctionne? Comment le savoir?
3. Qu’a fait cette personne, et quelles décisions a-t-elle prises?
4. Connaît-elle les limites du projet?

Le README du projet répond à ces questions. Un README est le premier fichier qu’on lit dans un projet : un court document texte qui l’explique. Sur GitHub, il apparaît sous la liste des fichiers.

Les parties d’un bon README

Section	Ce qu’elle contient	La question de la personne qui examine le projet
Problème	Qui vit le problème, quelle décision il touche et pourquoi il compte. De deux à quatre phrases.	Quel problème résout-il?
Données	Leur source, leur quantité, leur contenu et si elles sont synthétiques.	Puis-je me fier aux données d’entrée?
Approche	Ce que vous avez construit et les principaux choix, avec une raison pour chacun.	Qu’a fait cette personne?
Évaluation	Votre méthode de mesure, le résultat et la référence de base utilisée pour la comparaison.	Est-ce qu’il fonctionne?
Démonstration	Comment l’exécuter, avec la sortie attendue, ou une capture d’écran ou un court enregistrement.	Puis-je le voir?
Limites	Ce qu’il ne fait pas, ses échecs et ce que vous feriez ensuite.	Cette personne connaît-elle ses limites?
Ma contribution	Ce que vous avez fait vous-même. Dans un projet d’équipe, soyez précis.	Qu’a fait cette personne?

Ces sections reprennent les éléments du module 3 : le cadrage, la référence de base, l’évaluation et le coût des erreurs. Un bon projet de portfolio est une version réduite d’un vrai projet d’IA.

Exemple détaillé : le README de Daniela

Le livrable de Daniela pour la semaine 8 est un script qui repère les factures en double. Voici le plan de son README :

Problème. Les équipes de comptabilité paient certaines factures de fournisseurs deux fois. La même facture arrive par courriel et par la poste, avec de petites différences. Ce script repère les doublons probables avant le paiement, pour qu’un comptable puisse les vérifier.

Données. 200 factures synthétiques que j’ai créées, avec 24 doublons ajoutés volontairement : 12 copies exactes et 12 quasi-doublons. Ces derniers ont des espaces ou des tirets différents dans le numéro de facture, ou une date décalée d’un jour. Aucune donnée réelle d’entreprise.

Approche. Je nettoie chaque numéro de facture : je retire les espaces et les tirets, puis j’utilise des majuscules. Ensuite, je compare le fournisseur, le montant et le numéro nettoyé. J’ai choisi des règles, pas un modèle, car les types de problèmes sont connus. Un comptable peut facilement vérifier ces règles.

Évaluation. Référence de base, correspondance exacte de tous les champs : repère 12 doublons sur 24. Mon script : en repère 22 sur 24, avec 3 fausses alertes sur 200 factures.

Démonstration. python check_invoices.py invoices.csv affiche les paires de doublons probables. Un exemple de sortie est inclus.

Limites. Le script manque des doublons quand la deuxième facture a un montant différent, par exemple après un crédit partiel. Je l’ai testé seulement sur des données synthétiques. Prochaine étape : le tester sur un jeu de données public de factures.

Ma contribution. J’ai tout fait. Les types de problèmes viennent de mes sept années en comptabilité.

Remarquez ce qu’elle n’écrit pas : « une solution de facturation propulsée par l’IA ». C’est un script fondé sur des règles, et elle le dit. L’évaluation, avec une référence de base et des fausses alertes, montre plus de compétences qu’une grande affirmation.

Relier chaque affirmation à une preuve

Chaque affirmation dans votre CV ou votre profil doit avoir une flèche vers une preuve. Sans preuve, c'est une lacune.

Description textuelle du diagramme

• « Je peux écrire du Python pour vérifier des données » → le script de vérification des factures, avec des tests.
• « Je peux évaluer une méthode honnêtement » → le tableau de résultats comparant la méthode à la référence de base.
• « Je sais dans quels cas la vérification des factures échoue » → le README, avec 6 types de problèmes et un exemple de chacun.
• « Je peux construire des modèles d’apprentissage automatique » → lacune : aucune preuve pour l’instant. Retirez l’affirmation ou planifiez un projet qui fournit une preuve.

Faites cette vérification pour chaque compétence que vous affirmez avoir. Pour une lacune, vous avez deux options honnêtes : retirer l’affirmation ou ajouter à votre plan un projet qui fournit la preuve.

Planifier deux projets

Deux projets sont un bon départ. Choisissez-les pour qu’ensemble, ils montrent les compétences de votre rôle principal :

• Projet 1 : petit et bientôt terminé. Votre livrable du plan de huit semaines. Il montre que vous terminez ce que vous commencez.
• Projet 2 : plus proche du rôle visé. Plus tard dans votre parcours. Il montre la compétence principale du rôle, par exemple l’évaluation pour un spécialiste en évaluation, ou une fonctionnalité d’IA pour un ingénieur en IA.

Quand vous le pouvez, utilisez votre domaine. Un projet sur un problème que vous connaissez de l’intérieur est plus facile à expliquer et montre votre longueur d’avance.

Exercice guidé : deux fiches de projet

1. Dans notes.md, ajoutez un titre : ## Project briefs (fiches de projet).
2. Copiez le modèle ci-dessous deux fois : une fois pour le projet 1 et une fois pour le projet 2.
3. Remplissez chaque ligne. Pour le projet 2, l’approche peut être incertaine : écrivez ce que vous prévoyez.
4. Pour chaque projet, écrivez quelles compétences de votre inventaire il permet de prouver.

Project:
Problem (who, which decision, why it matters):
Data (source, size, synthetic or public, licence):
Approach (what I build, and one reason):
Baseline:
Success measure (a number):
Limitations that I expect:
Skills that it gives evidence for:
Week when it is finished:

Vérification : chaque fiche contient une référence de base, une mesure de réussite chiffrée et des données que vous pouvez publier.

Erreur courante

Un portfolio de copies de tutoriels

Symptôme : votre portfolio contient trois projets : un système de recommandation de films, un classificateur de chiffres manuscrits et un robot conversationnel. Chacun suit un tutoriel populaire en ligne. La personne qui les examine a vu les mêmes projets plusieurs fois et ne peut pas distinguer votre contribution.

Cause : les tutoriels sont utiles pour apprendre. Mais une copie montre que vous pouvez suivre des étapes, pas que vous pouvez prendre des décisions.

Solution : changez au moins un élément important et expliquez pourquoi. Mieux encore, choisissez un problème de votre domaine, avec vos propres données ou un jeu de données public. Présentez l’évaluation par rapport à une référence de base, ainsi que les limites. Ces sections montrent vos décisions, et c’est ce que les personnes qui examinent votre travail cherchent.

Vérifiez votre compréhension

Pourquoi « repère 22 doublons sur 24, contre 12 pour la correspondance exacte, avec 3 fausses alertes » est-il plus convaincant que « repère 92 % des doublons »?

Afficher la réponse

Cette formulation donne les vrais nombres, ce qui montre la petite taille du test. Elle compare le résultat à une référence de base, ce qui montre que la méthode apporte une valeur ajoutée. Elle signale les fausses alertes, ce qui montre que l’auteur comprend les deux types d’erreurs. « 92 % » seul cache ces trois éléments.

Vérifiez votre compréhension

Votre CV indique « expérience en apprentissage profond », mais votre portfolio ne contient aucun projet d'apprentissage profond. Quelles sont vos deux options honnêtes?

Afficher la réponse

Retirez l’affirmation ou planifiez un projet qui la prouve, sans l’inscrire dans votre CV avant d’avoir terminé le projet. Une affirmation sans preuve mène souvent à une question d’entrevue à laquelle vous ne pouvez pas répondre. Cela nuit aussi à la confiance envers vos autres affirmations.

Récapitulatif

• Un portfolio fournit des preuves des compétences que vous affirmez avoir.
• Un bon README contient : le problème, les données, l’approche, l’évaluation avec une référence de base, la démonstration, les limites et votre contribution.
• Reliez chaque affirmation à une preuve. Une affirmation sans preuve est une lacune : retirez-la ou planifiez un projet pour la prouver.
• Planifiez deux projets : un petit projet bientôt terminé et un autre plus proche du rôle visé, dans votre domaine si possible.

Ensuite, vous vous exercerez à parler de vos décisions et de votre contribution à un projet, sans exagérer.

Leçon suivante : Expliquer vos décisions