supprime AMELIORATIONS.md du dépôt (fichier local uniquement)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
1
.gitignore
vendored
1
.gitignore
vendored
@@ -24,3 +24,4 @@ Licence_IA*.jpeg
|
||||
|
||||
# Vidéos
|
||||
*.webm
|
||||
AMELIORATIONS.md
|
||||
|
||||
325
AMELIORATIONS.md
325
AMELIORATIONS.md
@@ -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*
|
||||
Reference in New Issue
Block a user