Refactoring chapitre 1

[AlexandreDubray]

Premier commit qui apporte une modification pour coller aux guidelines définies dans l'issue #9 . On pourra discuter dans cette PR des différents éléments de fond et voir comment améliorer le chapitre @Spirou07 @smax9698

[RobOWt]

Can I test this patch?

Reminder: my commands are

• "ok to test": to add this PR in the checklist of Jenkins
• "test this please": to trigger a new build I will only listen to repo owners.

[AlexandreDubray]

Voici les premières pistes d'améliorations pour la pédagogie du chapitre 1. Je vais détailler section par section et nous pourrons discuter des différents éléments.

De manière générale

• Je pense que ça serait pas mal de créer une section d'introduction où on pourrait dévelloper de manière "abstraite" avec quelques examples de la vie courante ce qu'est une variables (par exemple on pourrait comparer une variable à une boite à chaussure, et les chaussures seraient le contenu de la variables). Ca permettrait de faire une introduction en douceur pour ne pas brusquer le lecteur :-).
• Dans les exercices, généralement il y a une question diviser en plusieurs questions. On pourrait à la limite changer le système de QCM dans la webapp du syllabus pour faire quelques choses de plus "propre"

Syntaxe des noms de variable

• Est-ce que ce chapitre doit être mit en premier ? Au final la syntax des noms de variables n'est pas spécialement importantes comparée à "comment utiliser les variables" (déclaration et initialisation). On pourrait donc inverser les deux

Déclaration et affectation de variable

• Ne pas définir le terme variable ici, mais peut-être dans l'introduction (ou alors si ce chapitre passe en premier c'est ok)
• Pour les exemples de syntax du type <type><nom>, peut être expliqué la syntax. C'est à dire, prendre du temps pour dire que <type> représente n'importe quel type, que ce n'est pas du code, etc. (C'est dit vite fait mais pas trop insisté)
• Peut être un peu plus insister sur la différence entre déclaration et initialisation. C'est une différence que parfois les débutant ont du mal à comprendre, et je pense que ça vaut la peine de bien insister dessus
• Pour le premier exercice, on a l'impression que c'est le même bout de code alors que a priori ce sont chaque fois des possible-initialisations indépendantes
• Question 2 : il faudrait dire qu'on peut faire plusieurs initialisations sur une même ligne dans la théorie
• Question 4 : Il faudrait voir si l'on parle de la portée lexicale. Si oui alors il faut peut-être faire une section à part entière

Types de variables

• Par rapport aux précisions sur les type d'entier, il faudrait un peu plus expliquer pourquoi si un entier est codé sur 1 byte, il y a 256 valeurs possible (pas évident pour tout le monde)
• Le complément sur le type char se trouve entre la théorie et les exercices. Comme c'est un complément, il faudrait soit le mettre après, soit le mettre dans une section à part entière.

Variable dans les programmes

Je trouve le chapitre un peu redondant avec ce qui a été dit précédemment. Ce qu'il apport en plus peut être dit dans les autres chapitre et je propose donc de le supprimer et de rajouter son contenu dans les autre chapitre :-)

Voilà, j'attends vos retour avec impatiente! N'hésitez pas à commenter, rajouter des choses, appuyer les choses avec lesquelles vous êtes d'accord :-)

[francoismichel]

Le syllabus va bientôt être mis en ligne dans une première version, qui pourrait aider les étudiants en MATH qui n'auront pas l'APP0 en informatique. On appliquera donc les quelques changements qui nous paraissent indispensables pour qu'ils puissent l'utiliser dès la semaine prochaine. N'hésitez pas si vous avez des siggestions ou si vous voulez aussi appliquer des modifications. Il ne sera normalement pas un problème de mettre à jour les pages même après la mise en ligne du syllabus. :-)