diff --git a/.gitignore b/.gitignore index 7265d5c..d3ef12f 100644 --- a/.gitignore +++ b/.gitignore @@ -24,3 +24,4 @@ Licence_IA*.jpeg # Vidéos *.webm +AMELIORATIONS.md diff --git a/AMELIORATIONS.md b/AMELIORATIONS.md deleted file mode 100644 index 5db7cb3..0000000 --- a/AMELIORATIONS.md +++ /dev/null @@ -1,325 +0,0 @@ -# Récapitulatif des améliorations possibles - Cours NSI Première - -> Analyse complète du contenu pédagogique, chapitre par chapitre. - ---- - -## Vue d'ensemble - -Le cours est globalement **très complet et bien structuré**. Il couvre l'ensemble du programme officiel avec des exemples concrets et des projets motivants (Pokédex, Spotify, Minecraft, etc.). Voici les points d'amélioration identifiés. - ---- - -## 1. Représentation de base - -### Chapitre 1 - Entiers naturels -**Points forts** : Progression logique base 10 → base 2 → hexadécimal, exercices ludiques (films en binaire, recette de cuisine). - -**Améliorations réalisées** : -- [x] Niveaux de difficulté ajoutés aux exercices (⭐ à ⭐⭐⭐) - -**Améliorations possibles** : -- [ ] Ajouter des exercices Python pratiques (fonctions `bin()`, `hex()`, `int()`) -- [ ] Ajouter une section sur la fonction `format()` pour les conversions -- [ ] Les tableaux "À faire vous-même" pourraient avoir une correction en annexe - -### Chapitre 2 - Entiers relatifs -**Points forts** : Explication claire du complément à 2, exemple numpy pour l'overflow. - -**Améliorations possibles** : -- [ ] Ajouter un schéma visuel de la "roue" des entiers signés -- [ ] Exercices de conversion avec correction -- [ ] Exemple concret d'overflow avec conséquences réelles (bug du missile Patriot mentionné dans chapitre 3) - -### Chapitre 3 - Flottants -**Points forts** : Très complet, lien avec IEEE 754, bons exercices Python. - -**Améliorations possibles** : -- [ ] Le lien avec le bug du Patriot (dans exercices/PATRIOT/) pourrait être intégré dans le cours principal -- [ ] Ajouter un outil interactif de visualisation IEEE 754 (lien externe) - -### Chapitre 4 - Booléens -**Points forts** : Très complet, lien vers NANDGAME, tables de vérité claires. - -**Améliorations possibles** : -- [x] ~~Les fichiers PYTHON.md et KARNAUGH.md non liés~~ ✅ Sommaire ajouté -- [ ] Ajouter des exercices Python sur les opérateurs `and`, `or`, `not` -- [ ] Lier vers un simulateur de circuits logiques en ligne - -### Chapitre 5 - Texte/Encodage -**Points forts** : Bon historique, distinction ASCII/ISO-8859-1/UTF-8 claire. - -**Améliorations possibles** : -- [ ] Le cours est assez court comparé aux autres chapitres -- [ ] Ajouter des exercices Python avec `ord()`, `chr()`, `.encode()`, `.decode()` -- [ ] L'activité "débranchée" sur les systèmes historiques (Baudot, Morse) pourrait être mieux intégrée -- [ ] Manque la correction du TD - ---- - -## 2. Représentation des types construits - -### Chapitre 1 - Listes, tuples, itérations -**Points forts** : Contenu très complet, tableaux récapitulatifs utiles. - -**Améliorations possibles** : -- [ ] **Incohérence** : `namedtuple` est enseigné ici mais retiré des évaluations → clarifier si c'est au programme ou bonus -- [x] ~~Les f-strings sont utilisées~~ → Corrigé, remplacées par print() avec virgules -- [ ] Le TP Mastermind est bien conçu mais manque une correction - -### Chapitre 2 - Dictionnaires -**Points forts** : Clair et progressif, bonne explication de `.get()`. - -**Améliorations possibles** : -- [ ] Ajouter plus d'exemples de cas d'usage concrets -- [ ] Lier vers les exercices Pokédex mentionnés dans le dossier `exercices/` - -### Chapitre 3 - Structures imbriquées -**Points forts** : Bon exemple avec les personnages du Seigneur des Anneaux. - -**Améliorations possibles** : -- [ ] Chapitre très court (105 lignes) comparé aux autres -- [ ] Ajouter plus d'exemples et d'exercices -- [ ] Les compréhensions sont enseignées mais retirées des évaluations → clarifier le niveau attendu - -### Évaluations (TP01-TP10) -**Points forts** : Excellente variété de thèmes, squelettes bien structurés, fichiers d'aide adaptés. - -**Améliorations possibles** : -- [ ] Créer un corrigé pour chaque TP (pour l'enseignant) -- [ ] Ajouter un barème indicatif dans chaque TP - ---- - -## 3. Programmation Python - -### Structure générale -- [x] ~~Les README ne contenaient que des instructions~~ ✅ Mémos complets ajoutés - -**Améliorations réalisées** : -- [x] ~~Ajouter un résumé/mémo dans chaque README~~ ✅ Fait pour les 4 chapitres -- [ ] Créer un fichier `MEMO.md` récapitulant toute la syntaxe Python (optionnel) - -### Chapitre 1 - Variables ✅ -- [x] Types de base (int, float, str) -- [x] Opérateurs arithmétiques -- [x] Fonctions utiles (print, type, len, input) -- [x] Conversion de types -- [x] Règles de nommage - -### Chapitre 2 - Conditionnelles ✅ -- [x] Structure if/elif/else -- [x] Opérateurs de comparaison -- [x] Opérateurs logiques (and, or, not) -- [x] Exemple complet - -### Chapitre 3 - Boucles ✅ -- [x] Boucle for et range() -- [x] Boucle while -- [x] Comparaison for vs while -- [x] Attention aux boucles infinies - -### Chapitre 4 - Fonctions ✅ -- [x] Définition et appel -- [x] Paramètres et return -- [x] Valeurs par défaut -- [x] Portée des variables -- [x] Docstrings - ---- - -## 4. Algorithmes - -### Introduction aux algorithmes -**Points forts** : Bonne explication historique (Al-Khwarizmi), règles claires. - -**Améliorations possibles** : -- [ ] Le cours est très théorique (règles 0-11) → ajouter plus d'exemples pratiques -- [ ] Les images d'algorigrammes pourraient avoir des légendes explicatives - -### Algorithmes de tri -**Points forts** : Excellentes illustrations (GIF, schémas), preuves de correction. - -**Améliorations possibles** : -- [ ] Ajouter le tri à bulles (souvent demandé) -- [ ] Comparaison visuelle des performances avec différentes tailles de tableaux -- [ ] Le lien vers le simulateur est très bien, le mettre plus en évidence - -### Recherche dichotomique -**Points forts** : Explication claire, complexité bien détaillée. - -**Améliorations possibles** : -- [ ] Ajouter une version récursive de l'algorithme -- [ ] Exercice : trouver la racine carrée par dichotomie - -### Parcours séquentiel (PARCOURS.md) -- [ ] Vérifier que ce fichier existe et est complet - ---- - -## 5. Algorithmes gloutons - -**Points forts** : Excellents exemples (rendu de monnaie, sac à dos, voyageur de commerce), code Python complet. - -**Améliorations possibles** : -- [ ] L'exemple de Didier Deschamps est amusant mais pourrait être mis à jour -- [ ] Ajouter un exercice sur le problème du planning (interval scheduling) -- [ ] Visualisation graphique pour le problème du voyageur - ---- - -## 6. K-NN - -**Points forts** : Bon exemple avec les Pokémon, graphiques explicatifs. - -**Améliorations possibles** : -- [x] ~~Manque l'implémentation Python~~ → Existe déjà dans IMPLEMENTATION.md (très complète !) -- [x] ~~Les fichiers non liés depuis le README~~ → Sommaire ajouté au README -- [ ] Ajouter un TP complet avec scikit-learn ou implémentation manuelle - ---- - -## 7. Architecture - -### Structure générale -- [x] ~~Le fichier `architecture/README.md` n'existait pas~~ → Créé avec sommaire complet - -**Améliorations possibles** : -- [ ] Ajouter un schéma récapitulatif de l'architecture d'un ordinateur -- [ ] Vérifier que l'image `assets/bo.png` existe - -### Von Neumann -**Points forts** : Très complet, historique intéressant, pipeline expliqué. - -**Améliorations possibles** : -- [ ] Lien vers le fichier MEMOIRE.md et TURING.md depuis le README -- [ ] Ajouter des exercices pratiques - -### OS / Linux -- [ ] Vérifier que les notebooks `terminus.ipynb` et `tp_linux.ipynb` fonctionnent en standalone - -### M999 -- [ ] Vérifier la cohérence des instructions entre les deux fichiers d'instructions - ---- - -## 8. Réseaux - -### Adressage IP -**Points forts** : Excellente "méthode magique" pour les calculs, exercices progressifs. - -**Améliorations possibles** : -- [ ] Ajouter la correction (mentionnée mais non vérifiée) -- [ ] Section IPv6 pourrait être développée - -### TCP -- [ ] Vérifier le contenu du notebook et du README - -### DNS -- [ ] Vérifier le contenu du notebook - -### Filius (TP pratiques) -**Points forts** : 4 séances progressives, bien structuré. - -**Améliorations possibles** : -- [ ] Ajouter des captures d'écran de Filius dans les README des séances -- [ ] Créer un fichier de solution pour chaque séance - ---- - -## 9. Web - -### Introduction -**Points forts** : Bonne liste de ressources, historique intéressant. - -### HTML -**Points forts** : Très complet (580 lignes), structure exemplaire, nombreux exercices. - -**Améliorations possibles** : -- [ ] Modèle à suivre pour les autres chapitres ! - -### CSS -- [ ] Vérifier que le contenu est aussi complet que HTML -- [ ] Ajouter Flexbox et Grid (mentionnés dans les ressources) - -### JavaScript -- [ ] Vérifier le niveau de détail -- [ ] Adapter au programme (manipulation DOM basique) - ---- - -## 10. Données en table - -**Points forts** : Bon exemple avec les tortues ninja, code CSV clair. - -**Améliorations possibles** : -- [x] ~~Le code utilisait `eval()` dans `vers_csv()`~~ → Fonction réécrite proprement -- [x] ~~Les fichiers FUSION.md, MANIPULATION.md, PANDAS.md non liés~~ ✅ Sommaire ajouté -- [ ] Ajouter des exercices avec de vrais fichiers CSV (données ouvertes) - ---- - -## 11. Incohérences à harmoniser - -| Élément | Dans le cours | Dans les évaluations | Statut | -|---------|---------------|---------------------|--------| -| f-strings | ~~Utilisées~~ | Retirées | ✅ Corrigé - remplacées par print() | -| namedtuple | Enseigné (chap 1) | Retiré | ⚠️ Clarifier si bonus ou programme | -| Compréhensions | Enseignées (chap 3) | Retirées | ⚠️ Clarifier si bonus ou programme | -| `**kwargs` | Présent dans certains exemples | Retiré | À vérifier | - ---- - -## 12. Améliorations générales - -### Documentation -- [ ] Ajouter un fichier `MEMO_PYTHON.md` récapitulant toute la syntaxe Python de première -- [x] ~~Créer un glossaire des termes techniques~~ ✅ `GLOSSAIRE.md` créé (70+ termes) - -### Exercices -- [ ] Systématiser les fichiers `CORRECTION.md` pour tous les exercices -- [x] ~~Ajouter un niveau de difficulté (⭐ à ⭐⭐⭐)~~ ✅ Niveaux ajoutés aux exercices - -### Projets -- [ ] Documenter les projets mentionnés (Pokédex, Zoo, Calculatrice, Choipeaux) -- [ ] Ajouter des exemples de rendus attendus - -### Accessibilité -- [ ] Vérifier que toutes les images ont un texte alternatif -- [ ] Ajouter des transcriptions pour les vidéos - -### Liens -- [ ] Vérifier que tous les liens externes fonctionnent encore -- [ ] Certaines ressources mentionnées (FlexboxFroggy, etc.) pourraient avoir des alternatives locales - ---- - -## Priorités suggérées - -### Haute priorité ✅ CORRIGÉ -1. ~~Créer le `architecture/README.md` manquant~~ ✅ Créé -2. ~~Ajouter l'implémentation Python de KNN~~ ✅ Déjà existant dans IMPLEMENTATION.md, sommaire ajouté au README -3. ~~Harmoniser f-strings entre cours et évaluations~~ ✅ Toutes les f-strings remplacées par print() avec virgules -4. ~~Remplacer `eval()` dans donnees_en_table~~ ✅ Fonction réécrite proprement - -### Moyenne priorité ✅ CORRIGÉ -1. ~~Ajouter des résumés dans les README de programmation~~ ✅ Mémos ajoutés aux 4 chapitres -2. Compléter les corrections manquantes → Corrections manquantes identifiées (voir ci-dessous) -3. ~~Lier les fichiers non référencés~~ ✅ Sommaires ajoutés (booléens, KNN, données en table) - -### Basse priorité ✅ CORRIGÉ -1. Ajouter plus de ressources visuelles → À faire au fil du temps -2. ~~Créer le glossaire~~ ✅ GLOSSAIRE.md créé avec 70+ termes -3. ~~Ajouter les niveaux de difficulté aux exercices~~ ✅ Niveaux ajoutés (⭐ à ⭐⭐⭐) - -### Corrections manquantes identifiées -Les fichiers d'exercices suivants n'ont pas de correction associée : -- `representation_base/chapitre_1/EXERCICES.md` et `EXERCICES_2.md` -- `representation_base/chapitre_2/EXERCICES.md` -- `gloutons/EXERCICES.md` -- `knn/EXERCICES.md` - ---- - -*Document généré le 29/01/2026* -*Analyse effectuée par Claude Code*