edunumsec2/book

Ressources pour l'enseignement de l'informatique au Gymnase.

Moyens d'enseignement pour l'informatique au Gymnase

Ce répertoire contient le code source des moyens d'enseignement Modulo mis en place par la DGEP, l'EPFL, la HEP Vaud et l'Unil.

Dans le cadre du plan d'études romand pour l'enseignement de l'informatique au gymnase, Modulo propose une aide qui se compose de deux parties :

• Apprendre: qui propose des ressources didactives à la destination des élèves (Représentation de l'information, Programmation I, Programmation II, Algorithmique I, Algorithmique II, Architecture des ordinateurs, Histoire de l'informatique, Projets informatiques)
• Enseigner: qui propose des ressources pédagogiques aux enseignant-es (Enjeux sociaux du numérique, idées d'activités pour chaque thématique, corrections d'exercices proposés sur Apprendre, etc.)

Ces ressources sont mises à disposition selon les termes de la Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 3.0.

Installation • Contribuer • Code de conduite • Gouvernance • Comité • Discord • Plugs-in

book's Issues

[Contenu]:

Page

book/content/appr/theme/archi/cours/0_intro/eleve.md

Quelle est le problème relevé ?

Certaines affirmations sont à contre-sens, la référence systématique à des courants plutôt que des tensions est discutable. Il reprend des éléments de l'histoire alors qu'il serait plus efficace d'y faire référence.

La référence à "au modèle A9 de Apple, commercialisé dans les iPhone SE." se justifie-t-elle comment ? Pourquoi pas le A7 ?

Il y a aussi beaucoup de coquilles au niveau de l'orthographe et de la syntaxe.

Quelle est votre suggestion ?

J ai déjà corrigé la présentation de l'ordinateur Setun qui contenait des contre-vérités

Code of Conduct

• J'accepte de suivre le code de conduite.

@edunum-sec2 : Clarification de la consigne

book/content/theme/algorithmique-avancee/cours/heuristiques/eleve.md

Line 90 in 748bf8d

Pour chaque élément on doit parcourir le tableau 2 fois, on a donc une complexité de n * n * n = n<sup>3</sup>, ou une complexité cubique.

Issue on page /content/appr/theme/archi/cours/2_additionneur/eleve.html

La définition de modulaire dans le texte pointe vers l'arithmétique modulaire, ce qui n'est pas approprié dans ce cas.

Congruence sur façon de donner des instructions aux élèves.

Quels sont les règles d'orthographe pour donner des instructions aux élèves ?

• Impératif (faites ceci, écrivez cela)
• indicatif (faire ceci, écrire cela)

Les 2 peuvent être acceptable. mais il faut être uniforme sur le site et à minima sur une page.

Issue on page /content/ens/theme/algo1/accueil/solutions.html

[Contenu]: Exercice demandant l'utilisation d'une instruction conditionnelle alors que cela n'a pas encore été traité

Page

https://apprendre.modulo-info.ch/prog1/repeter.html#la-tortue

Quel est le problème relevé ?

L'exercice donne un programme qui dessine un hexagone et qui stamp() chaque sommet. Il faut désormais le modifier pour que seul un sommet sur deux ne soit stamp().

Il me semble que cela doit faire intervenir une instruction conditionnelle qui n'a pas encore été vue si l'on suit les chapitres dans l'ordre du menu.

Quelle est votre suggestion ?

Déplacer cet exercice dans le chapitre 13 : Décider if.

Code of Conduct

• J'accepte de suivre le code de conduite.

@dasilvadds : ajouter une illustration de la représentation de qqqchose en binaire

book/content/appr/theme/rep-info/cours/intro/eleve.md

Line 196 in 5494519

<center>

[Contenu]: Virerions-nous le "copyright" pour mettre un CC-by-nc à la place?

Page

Toutes

Quel est le problème relevé ?

Le copyright du bas de page semble contredire notre licence

Quelle est votre suggestion ?

Virer le copyright et montrer le petit logo de notre licence (en français)

This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License.

Code of Conduct

• J'accepte de suivre le code de conduite.

Issue on page /content/appr/theme/algo2/cours/heuristiques/eleve.html

La solution de l'exercice 2 est fausse. Même en parcourant deux fois ça reste du n^2.

Matrices éditables pour créer images Bitmap dans représentation des images

Je recopie ici un commentaire anonyme trouvé dans les sondages sur représentation de l'information, que l'on pourrait mettre en place :

""Les élèves ont très bien accroché, mais ils ont découvert que dans le même ""bitmap éditable"" (le seul éditable) ils pouvaient remplacer les 0 et 1 par des nombres plus grand (et obtenir ainsi des niveaux de gris) ou des triplets (interprétés alors comme rgb). Or, cela ""casse"" un des objectifs (à mon sens) de cette activité, qui est de comprendre ""combien de place"" prend l'image (au format bitmap). Ce serait nettement plus clair si le code éditable apparaissait en trois exemplaires indépendants, dont un n'accepte que des 0 et 1 dans le tableau, l'autre des nombres entre 0 et 255 (interprétés effectivement comme niveaux de gris du moins intense au plus intense - pas tout à fait le cas actuellement), et l'autre des triplets RGB. Ainsi, il devient ""évident"" (càd visible à l'oeil) que dans le premier cas on utilise 1 bit par pixel, le deuxième un octet par pixel, et le 3ème trois octets par pixel - ce qui est intéressant dans le cadre de ce chapitre (et permet aussi de discuter de la possibilité de restreindre ou augmenter les niveaux de gris ou de RGB possibles avec les conséquences
correspondantes sur la taille du bitmap)."

Issue on page /content/theme/programmation/cours/2_pyth/pyth.html

bonjour, un petit mot pour partager mes interogations ... Python est pour moi un langage compilé et interprété (étape en bytecode), contrairement à Lisp qui n'est qu'interprété. La simplification est-elle volontaire? Merci!

Dependabot alerts ?

Page

requirements.txt

Que s'est-il passé ?

Que fait-on des bugs d'alertes de dependabot ?

https://github.com/edunumsec2/book/security/dependabot

Quel résultat était attendu ?

On n'aimerait pas des erreurs comme ça je pense :

Sur quel navigateur ?

Autre

Quel format ?

Mobile, Desktop

Logs pertinents

No response

Code of Conduct

• J'accepte de suivre le code de conduite.

Issue on page /content/appr/theme/prog1/cours/1_intro/intro.html

Incrémentation :
Le score total est de 10 au lieu de 3 (si on a tout juste, on obtient 3/10 et non 3/3).

Manque de clarté entre unicode le standard et les différents encodages

book/src/appr/rep-info/caracteres.md

Lines 164 to 177 in 009ff90

	## Standard UTF
	Le [standard Unicode](https://home.unicode.org/) UTF (Universal Character Set Transformation Format)
	s'est imposé pour l'échange, car il permet d'agréger sur 8 bits, 16 bits ou 32 bits par caractère la totalité des caractères utilisés dans toutes les langues humaines… et même extraterrestres,
	puisque le [Klingon](https://www.kli.org/about-klingon/klingon-history/) est également intégré.
	Les caractères liés à l'édition des partitions de musique ou les émojis sont également intégrés.
	### Variantes
	Pour éviter de consommer 32 bits par caractère, des variantes plus compactes
	ont été mises à disposition.
	La plus connue – des européens, puisqu'elle regroupe les caractères qui nous concernent – est la [table UTF-8](https://www.utf8-chartable.de/). Elle se concentre sur les premiers 8 bits de la table UTF complète.

A mon avis il serait mieux d'expliquer d'abord unicode (sans parler des encodages), puis introduire clairement les différents encodages.
Par exemple la phrase "la table utf8 se concentre sur les premiers 8 bits de la table UTF complète" pourrait prêter à confusion

Je n'ai pas encore vraiment contribué à modulo, si vous me donnez le feu vert je ferais une petite pull-request pour cette petite partie de chapitre.

[Contenu]: images annotées en anglais

Page

Général

Quel est le problème relevé ?

Beaucoup d'images de la partie apprendre ont des annotations en anglais ce qui peut nuire à leur compréhension par les élèves et à la qualité du rendu.

Quelle est votre suggestion ?

Les remplacer par des images annotées en français ou éditer les svg (s'ils sont disponibles) pour remplacer les annotations.

Code of Conduct

• J'accepte de suivre le code de conduite.

[Bug]: "No module names 'qrcode'"

Page

Extension video.py

Que s'est-il passé ?

A l'exécution du book (enseigner ou apprendre), j'obtiens l'erreur suivante :

gregoire@gregoire-ThinkPad-P14s-Gen-2i:~/Desktop/dev/book-modulo$ source .env/bin/activate; sphinx-build src/ens build -E
bash: .env/bin/activate: No such file or directory
Running Sphinx v4.2.0
loading translations [fr]... done

Extension error:
Could not import extension videos (exception: No module named 'qrcode')

Je n'avais pas cette erreur avant et je n'ose pas bidouiller l'extension video.py.

Quelqu'un a une idée ?

Quel résultat était attendu ?

Build fonctionnel.

Sur quel navigateur ?

Firefox

Quel format ?

Mobile, Desktop

Logs pertinents

No response

Code of Conduct

• J'accepte de suivre le code de conduite.

Issue on page /content/appr/theme/prog1/cours/1_intro/intro.html

Langages Web:
j'ai de la peine à considérer Javascript comme un langage de balisage, il s'agit bien d'un langage de programmation, non ?

Quiz:
Ce quiz sur Python est-il bien au bon endroit ? Il conclut la page introductive où on ne parle pas du tout de ce langage.

Correction tampons

Page

https://apprendre.modulo-info.ch/content/appr/theme/prog1/cours/5_list/list.html

Quel est le problème relevé ?

Erreur sur le code :
tampon = ['h', 'a']
tampon.append('m')
print(tampon)
pop(0)
print(tampon)

Quelle est votre suggestion ?

Correction

tampon = ['h', 'a']
tampon.append('m')
print(tampon)
tampon.pop(0)
print(tampon)

Code of Conduct

• J'accepte de suivre le code de conduite.

Représentation de l'informatique : coquilles

Section représentation des entiers (livre élève)

Coquilles
Le système décimal
2e paragraphe: "... n'ont pas la même valeur : Le..." mettre une minscule à "Le.." (après un double point)

Représentation des entiers négatifs
2e paragraphe : "Un entier relatif et un entier naturel auquel on a ajoute... (supprimer le "a")
paragraphe juste en dessous de la fig. 6 : "domaine couvert pour ... les entiers relatifs [-8, 7]" (au lieu de [-8,-7]) (si j'ai bien compris ;-))

@farenc-c Écrire partie sur bases de données

book/content/theme/representation-information/cours/stockage-manipulation-donnees/eleve.md

Line 32 in 271248d

[Design]: module Questions

Page

Par exemple : /prog1/dessiner.html

Que s'est-il passé ?

Branche 'migration'.

Le @media (prefers-color-scheme: dark) dans src/exts/static/questions.css n'a pas d'impact lorsque l'on change de thème :

Quel résultat était attendu ?

Pouvoir lire :')

Plus globalement, je ne comprends pas vraiment pourquoi ça ne fonctionne pas. Selon la doc de Furo, le thème se base sur prefers-color-scheme...

Sur quel navigateur ?

Firefox, Chrome, Safari, Microsoft Edge, Opera, Autre

Quel format ?

Mobile, Desktop

Logs pertinents

No response

Code of Conduct

• J'accepte de suivre le code de conduite.

[Contenu]:

Page

https://apprendre.modulo-info.ch/content/appr/theme/prog1/cours/7_fonc/fonc.html

Quel est le problème relevé ?

def pythagore(a, b):
print(pythagore(3, 4))

Quelle est votre suggestion ?

def pythagore(a, b):
return ((a2+b2)**(1/2))
print(pythagore(3, 4))

Code of Conduct

• J'accepte de suivre le code de conduite.

Impossible d'ouvrir le livret de cours

Bonjour,

Depuis Github https://github.com/orgs/edunumsec2/people je n'arrive pas à ouvrir le livret de cours (Documents importants), il me faudrait un accès à files.edunumsec2.ch

Merci d'avance,

Vanina

**Documents importants

Livret de cours décrivant le découpage du plan d'études dans le détail.** -> impossible d'y accéder

[Contenu]: Economie du numérique et moteur de recherche - source et clarification

Page

https://enseigner.modulo-info.ch/enjx1/grandes-thematiques/economie-numerique.html#pistes-pedagogiques

Quel est le problème relevé ?

Dans la question e) du dossier 1.B, on mentionne le moteur de recherche Qwant comme "régulièrement pointé du doigt pour son partenariat avec Microsoft et son moteur de recherche Bing, dont sont issus une large part des résultats.", et elle n'est pas sourcée.

De même, cette mention me semble s'appliquer aussi à DuckDuckGo mais cela n'est pas mentionné.

Quelle est votre suggestion ?

Serait-il possible de sourcer cette information ?

De plus, si ce reproche est fait à Qwant, serait-il envisageable de le faire également à DuckDuckGo ? https://www.bleepingcomputer.com/news/security/duckduckgo-browser-allows-microsoft-trackers-due-to-search-agreement/

Code of Conduct

• J'accepte de suivre le code de conduite.

[Bug]:

Page

https://dev-apprendre.modulo-info.ch/rep-info/entiers.html

Que s'est-il passé ?

Il y a une erreur sur l'image

Quel résultat était attendu ?

Résultat attendu - Corrigé 2x -6

Sur quel navigateur ?

Autre

Logs pertinents

No response

[Bug]: Codeplay erreur 404

Page

/prog1/parcourir.html, par exemple

Que s'est-il passé ?

Sur Windows, dans le nouveau book : Codeplay affiche "404 : Not found".

Je trouve étrange qu'il aille chercher un fichier dans [thématique]/codeplay/frame.html car ce fichier n'existe pas.

Quel résultat était attendu ?

Afficher l'iFrame et son contenu.

Sur quel navigateur ?

Firefox

Quel format ?

Mobile, Desktop

Logs pertinents

GEThttp://127.0.0.1:8000/prog1/codeplay/frame.html
[HTTP/1.1 404 Not Found 3ms]

	
GET
	http://127.0.0.1:8000/prog1/codeplay/frame.html
Status
404
Not Found
VersionHTTP/1.1
Transferred219 B (69 B size)
Referrer Policystrict-origin-when-cross-origin

    	
    Content-Length
    	69
    Content-Type
    	text/html; charset=UTF-8
    Date
    	Thu, 17 Mar 2022 12:25:48 GMT
    Server
    	TornadoServer/6.1
    	
    Accept
    	text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8
    Accept-Encoding
    	gzip, deflate
    Accept-Language
    	en-US,en;q=0.5
    Cache-Control
    	max-age=0
    Connection
    	keep-alive
    DNT
    	1
    Host
    	127.0.0.1:8000
    Referer
    	http://127.0.0.1:8000/prog1/parcourir.html
    Sec-Fetch-Dest
    	iframe
    Sec-Fetch-Mode
    	navigate
    Sec-Fetch-Site
    	same-origin
    Upgrade-Insecure-Requests
    	1
    User-Agent
    	Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:98.0) Gecko/20100101 Firefox/98.0

Code of Conduct

• J'accepte de suivre le code de conduite.

[Bug]: .mov not working on Chrome

Page

https://dev-apprendre.modulo-info.ch/rep-info/son.html

Que s'est-il passé ?

Les fichiers Quicktime ".mov" ne sont plus supportés par Chrome. Une suggestion serait d'utiliser MP4 pour encoder les vidéos plutôt que .mov. Cela offrirait une plus grande universalité de lecture sur les navigateurs.

Proof of concept dans ce commit : ae71edf.

Quel résultat était attendu ?

Possibilité de lire les vidéos sur un maximum de navigateurs différents.

Sur quel navigateur ?

Chrome

Quel format ?

Desktop

Logs pertinents

No response

Code of Conduct

• J'accepte de suivre le code de conduite.

@elliotvaucher : panel question et darkmode

book/content/appr/theme/rep-info/cours/intro/eleve.md

Line 196 in 5494519

<center>

Les panels questions semble ne pas bien être rendus avec le darkmode, ils sont blanchatre, un peu comme grisés et le texte et difficilement lisible ?!

[Bug]: chargement de fichiers Excel

Page

https://dev-enseigner.modulo-info.ch/rep-info/activ/echantillonnage.html

Que s'est-il passé ?

Auparavant j'utilisais Download pour permettre le téléchargement d'un fichier excel (fin de la page).
Devoir - évaluation maison de type quizz moodle ne fonctionne pas...

Quel résultat était attendu ?

Résultat attendu : chargement du fichier Excel ...

Sur quel navigateur ?

Safari

Quel format ?

Desktop

Logs pertinents

No response

Code of Conduct

• J'accepte de suivre le code de conduite.

[Contenu]:

Page

http://127.0.0.1:8000/archi/activ/gabuzomeu.html#

Quel est le problème relevé ?

Inclure des vidéos dans une page (source, fichier dans media)

Quelle est votre suggestion ?

Est-ce qu'on peut inclure une vidéo qui ne vienne pas de youtube directement dans une page (embed) ?
(sinon je crois qu'il existe un plugin sphinx pour inclure des vidéo en html5)
Et si on pouvait aussi la rendre downloadable....

Code of Conduct

• J'accepte de suivre le code de conduite.

Représentation des images : coquilles

Représentation de l'information
Merci pour les corrections précédentes, voici de nouvelles coquilles repérées :

> Représentation des images
Codage des couleurs
§1: Il y a redondance d'additif à la "synthèse additive additif"

Les images vectorielles
§1: "... mais on peut aussi tout simplement de dessiner... " (supprimer le "de")

> Numérisation
Echantillonnage
Légende fig. 12 : "Puis la fréquence est élevée, puis la..." : remplacer "Puis" par "Plus"

> Redondance
Fonction de hachage
Bloc "Le saviez-vous ?", première phrase pas claire : "Même si le d'une information soit à dessein relativement rapide en soi..." : remplacer par "est" ?
Abus d'utilisation de l'expression "On notera" (3 à la suite dans cette partie...)

Numérotation automatique des chapitres et sections

Page

Toutes

Quel est le problème relevé ?

Les sections et sous-sections en Markdown doivent être numérotées à la main.

Ça pose problème d'une part parce qu'on est des humains et qu'on se plante (je viens de corriger un 3.3 qui suivait directement un 3.1) et d'autre part parce qu'une insertion de sections ou sous-sections demande une renumérotation manuelle fastidieuse de tout ce qui suit…

Quelle est votre suggestion ?

Faire en sorte que la numération soit automatique

Code of Conduct

• J'accepte de suivre le code de conduite.

[Bug]: Source markdown servie avec mauvaise indication de l'encodage

Page

Toutes

Que s'est-il passé ?

Le pied de page permet de voir le source Markdown de la page. C'est un document texte avec l'encodage UTF-8. Mais mon browser ne l'affiche pas en UTF-8, ce qui cause des soucis d'affichage.

Quel résultat était attendu ?

La page devrait être service avec ce header:

Content-Type: text/plain; charset=utf-8

Sur quel navigateur ?

Safari

Quel format ?

Desktop

Logs pertinents

No response

Code of Conduct

• J'accepte de suivre le code de conduite.

Compréhension de la consigne

Telle que l'exercice est posé, je comprend que pour chaque élément le parcours se fait 2 fois, donc 2 x n, la complexité reste en O(n^2)... ou alors j'ai mal compris

Ancienne définition kilo-octet

Situez l'erreur relevée

Dans https://github.com/edunumsec2/book/blob/master/content/theme/representation-information/cours/representation-entiers/eleve.ipynb, dans une admonition "le saviez-vous?".

Ce qui vous semble erroné

Il est dit qu'un kilo-octet est 1024 octets.
Cette définition n'est plus d'actualité.

Formulation correcte

Je propose qu'on s'aligne sur le Système International d'unités (SI) et qu'on dise qu'un kilo-octet fait 1000 octets.

Alternatives

Il est possible d'utiliser à la place le terme de kibioctet pour parler de 1024 octet, bien que l'usage ne semble pas prendre.

Issue on page /content/appr/theme/prog1/cours/1_intro/intro.html

Le programme machine de Turing ne s'affiche pas en entier lorsqu'on choisit le programme Palindrome. Il y a bien les ascenseurs, mais c'est pas dingue... Y a-t-il moyen d'automatiser la taille de la fenêtre ?

[Bug]: Affichage des cellules codeplay dans Prog (NEW)

Page

content/appr/theme/prog1/new/intro.html

Que s'est-il passé ?

Les cellules codeplay ne s'affichaient pas.

Quel résultat était attendu ?

Affichage des cellules codeplay.

Sur quel navigateur ?

Chrome

Quel format ?

Desktop

Logs pertinents

No response

Code of Conduct

• J'accepte de suivre le code de conduite.

[Bug]: Problème avec le Glossaire

Page

Toutes les pages

Que s'est-il passé ?

Sur le nouveau book Furo, Windows, l'extension Glossary génère une erreur lors du build.

Le site se build bien, mais les mots glossaires s'affichent comme suit :

Quel résultat était attendu ?

Pas d'erreur et affichage propre de l'extension.

Sur quel navigateur ?

Firefox

Quel format ?

Mobile, Desktop

Logs pertinents

Extension error (glossary):
Handler <function load_glossary_csv at 0x00000213FE7F0AF0> for event 'env-before-read-docs' threw an exception (exception: 'charmap' codec can't decode byte 0x81 in position 2415: character maps to <undefined>)
Command exited with exit code: 2

Code of Conduct

• J'accepte de suivre le code de conduite.

Issue on page /content/theme/representation-information/cours/representation-caracteres/eleve.html

Le dernier paragraphe, sur UTF-8, semble un peu trompeur. Il semble indiquer que l'encodage se fait toujours sur 8 bits, alors que l'encodage est de longueur variable (1, 2, 3 ou 4 octets).

Capacité d'un canal ? Symbol rate ?

book/content/theme/representation-information/cours/introduction/eleve.md

Line 65 in 36a174b

Imaginez que vous deviez choisir un *code* pour vous transmettre des informations avec l'une ou l'autre de vos camarades. Si vous utilisez un langage des signes, la distance à laquelle vous pourrez communiquer ne sera pas très grande. À plus de 50m il deviendra difficile de lire les mains de votre camarade. Si vous choisissez des signaux sonores, il suffit qu'il y ait du bruit environnant pour brouiller votre message. Si vous utilisez des signaux lumineux, ils ne seront pas visibles en plein jour.

Jusqu'où faut-il aller dans l'ouverture de questionnements concernant la rapidité de modulation (symbol rate) ou la capacité d'un canal (channel capacity) ? Peut-être que dans le chapitre "représentation de l'information" il faudrait aborder ça quelque part ?

[Contenu]:

Page

book/content/appr/theme/archi/cours/6_conclusion/eleve.md

Quelle est le problème relevé ?

La aussi plusieurs problemes :

• Que signifie cette formule? Entrée _____________________calcul - communication - mémoire _____________________sortie
• La question "Qu’est-ce-qu’un ordinateur ?" répétée sans que ce soit un effet stylistique.
• A quoi correspond ce narratif du sondage ?
• Terminer le chapitre Archi par "finalement finalement, au problème de la perception" pour ensuite repartir sur les composants et finir par : "Nouvelle conception d’architecture hybride de type «gratte-ciel» : elle est basée sur des matériaux plus avancés que le silicium ; les unités de mémoire et les transistors à base de nanotubes de carbone sont empilés successivement" Buzz techno .... ?

Quelle est votre suggestion ?

A reprendre et structurer ...

Code of Conduct

• J'accepte de suivre le code de conduite.

Formulation

#TODO

book/content/appr/theme/prog1/new/attendre.md

Line 131 in 9f89401

Des blocs marqué par une indentation se trouvent après les mots-clés pour :

[Bug]: .gitignore

Page

Dans le répertoire GitHub

Que s'est-il passé ?

Dans le .gitignore, on ignore _docs/ et _build/.

Or le dossier docs se retrouve dans le dépôt GitHub.

Quel résultat était attendu ?

Je propose qu'on mette à jour le .gitignore, car l'output de 250Mo+ ne devrait pas être push/pull à chaque fois.

Sur quel navigateur ?

Autre

Quel format ?

Mobile

Logs pertinents

No response

Code of Conduct

• J'accepte de suivre le code de conduite.