Tutoriel SDZ

je propose que ce sujet serve pour nos dicussions autour du tutoriel du sdz, pour se répartir les taches , etc...

Je re-place ici les points à modifier sur le tuto actuel pour que l'on s'en rappelle :
[quote=Nanoc]Votre tutoriel aura de la peine à trouver son public.
S'il est destiné aux débutants (ce qui semble être le cas), alors il faudrait expliquer ce qu'est une boucle, une condition, etc. Ou expliquer comment installer l'interpréteur et l'utiliser.

Vous donnez des définitions, mais ce n'est pas suffisant si le lecteur n'a jamais entendu parlé de programmation, même si la "syntaxe" du langage est très simple. Il faudrait développer cela en plusieurs chapitres et ce tutoriel deviendrait alors un big-tuto. Il faudrait expliquer comment écrire les "phrases" que Linotte va interpréter. D'après le site officiel, ce langage est destiné aux enfants, il faudrait donc que votre cours soit aussi destiné aux enfants.

Si, au contraire, votre tutoriel est destiné aux gens ayant déjà des connaissances dans d'autres langages de programmation, il faudrait alors plus développer le coté comparaison entre les langages, expliquer que c'est basé sur JAVA, montrer ce qui est original, etc...

De manière générale, vous devriez montrer le résultat des codes que vous présentez. Cela aide à se représenter ce qui se passe.
Comme déjà dit, c'est très dense et je ne suis pas sûr qu'un utilisateur (même sachant programmer dans un autre langage) sache utiliser correctement Linotte à la fin de la lecture de votre cours.

C'est quoi un "grand rôle" ? Une variable globale ?
Ne devriez-vous pas expliquer que le code se lit comme un script de théâtre/cinéma ?

Bref, le sujet est intéressant et mérite d'être développé, mais il y a encore du travail avant qu'il ne puisse être validé.

Bon point quand même, vous avez une bonne orthographe/grammaire.[/quote]

J'ai épinglé la discution pour qu'elle reste toujours en haut de la liste.

voici une première ébauche de plan pour transformer le mini-tuto en big-tuto :
les verbes présentés dans chaque partie sont mis entre crochets.

1) présentation "qu'est-ce qu'un langage de programmation ?"
2) téléchargement et présentation de l'atelier.
3) structure simple d'un livre (livre: paragraphe: actions:) [afficher][terminer]
4) variables texte et nombre + acteurs spéciaux (heure..) [copier] [ajouter] [demander][questionner]
5) notions mathématiques [multiplier][soustraire][diviser] + écriture rapide var = x + y * sin( 45 )
6) se déplacer entre les paragraphes [aller][parcourir][revenir][effacer le tableau]
7) condition + sous-paragraphe [lire][ferme]
boucles + variables casier [extraire][vider]
9) verbes utiles [mesurer][inverser][mélanger][trier][chercher][insérer]
10) variables espèce + utilisation du @

11) espèces graphiques de base [projeter][déplacer][attendre]
12) crayon
13) interface avec l'utilisateur [temporiser][temporiser n secondes]
14) polygone, graffiti, parchemin, etc..
15) évenements [faire réagir]

16) drapeau
17) allocation dynamique [créer]
18) paramètres + fonction * [parcourir avec]
19) acteur local §
20) traitement parallèle [appeler]
21) clonage #
22) produit cathésien
23) conseils pour déboguer un livre [deboguer]


et il faudrait ajouter aussi des tp de temps en temps, de difficulté croissante.

Si je comprend bien, $imon, il y a trois parties avec 1/ Les bases
2/ Le graphisme
3/ Fonctions avavancés

Petites questions :

- Pourquoi mettre la drapeau aussi tard ?
- La présentation de Linotte se fait dans le 1), en complément de la problématique, ou le 2) ?

[quote=LawNask]Si je comprend bien, $imon, il y a trois parties avec 1/ Les bases
2/ Le graphisme
3/ Fonctions avavancés[/quote]
c'est ce que j'ai voulu suggérer, mais je sais pas trop car, du coup, il y aurait une deuxième partie plus courte que les 2 autres.

[quote=LawNask]- Pourquoi mettre la drapeau aussi tard ?[/quote]
j'ai mis dans un premier temps uniquement les notions indispensables à l'utilisation du graphisme en Linotte.
après... c'est vrai que le drapeau n'est pas très difficile à comprendre, on pourrait le mettre après les conditions ou après les boucles.

[quote=LawNask]- La présentation de Linotte se fait dans le 1), en complément de la problématique, ou le 2) ?[/quote]
la présentation de Linotte se ferait dans le 1 (c'est un logiciel libre, c'est un interpreteur, il est développé en java, etc.. )
la présentation de l'atelier Linotte se ferait dans le 2 (la partie cahier, la partie tableau, les boutons lire, stop, édition.....)

[quote=$imon][quote=LawNask]Si je comprend bien, $imon, il y a trois parties avec 1/ Les bases
2/ Le graphisme
3/ Fonctions avancés[/quote]
c'est ce que j'ai voulu suggérer, mais je sais pas trop car, du coup, il y aurait une deuxième partie plus courte que les 2 autres.[/quote]
Si la partie graphisme est un peu plus courte, à mon avis, ce n'est pas grave, car au ressentis, c'est ce qui est le plus drôle. En mettant quelques TP, ça devrais passer tout seul " title="Big Grin" /> !

alors voici la deuxieme version:

NOTIONS DE BASE
1) présentation "qu'est-ce qu'un langage de programmation ?"
2) téléchargement et présentation de l'atelier.
3) structure simple d'un livre (livre: paragraphe: actions:) [afficher][terminer]
4) variables texte et nombre + acteurs spéciaux (heure..) [copier] [ajouter] [demander][questionner]
5) notions mathématiques [multiplier][soustraire][diviser] + écriture rapide var = x + y * sin( 45 )
6) se déplacer entre les paragraphes [aller][parcourir][revenir][effacer le tableau]
7) condition + sous-paragraphe [lire][ferme]
boucles + variables casier [extraire][vider]
9) souffleurs
10) variables drapeau
11) verbes utiles [mesurer][inverser][mélanger][trier][chercher][insérer]

GRAPHISME
12) variables espèce + utilisation du @
13) espèces graphiques de base [projeter][déplacer][attendre]
14) crayon
15) interface avec l'utilisateur [temporiser][temporiser n secondes]
16) polygone, graffiti, parchemin, etc..
17) évenements [faire réagir]

PROGRAMMATION AVANCEE
18) allocation dynamique [créer]
19) paramètres + fonction * [parcourir avec]
20) acteur local §
21) traitement parallèle [appeler]
22) clonage #
23) produit cathésien
24) bibliothèques
24) conseils pour déboguer un livre [deboguer]

j'ai modifié la place du drapeau, j'ai ajouté aussi un chapitre sur les bibliothèques et un sur les souffleurs.
là encore, je ne sais pas trop où mettre les souffleurs, c'est une notion simple, mais est-ce bien utile de surcharger la premiere partie ?
du coup, j'ai mis le chapitre sur les espèces dans la section: graphisme, car on peut considérer que ce chapitre est une sorte d'introduction au graphisme.

Le sommaire me semble concis et clair et surtout progressif.

Les souffleurs, c'est vrai que personne ne les utilise beaucoup je pense... Tu peux les mettre de côté pour l'instant.

Les soufleurs, c'est bien Dès que condition, action ?
Si oui, c'est vrai qu'il vaut mieux le mettre vers la fin.

Sinon, ton plan me plait bien, donc, on commence quand " title="Big Grin" /> ?

on comence maintenant !

il faut se répartir les taches:
Moi je n'ai pas préférence, alors que préférez-vous faire ?

(il y a juste le chapitre 2 que je ne pourrais pas faire car je ne connais pas la procédure d'installation sur Linux, il faudrait mettre des captures d'écran de la procédure pas à pas, sur chaque os )

Il peut être interessant de créer une page sur le wiki avec les différents points du sommaire et d'attacher devant chaque chapitre le nom de l'éditeur et son pourcentage d'avancement.
Sinon, on peut le le faire directement sur ce post du forum.

Je vous laisse avancer sur le tuto. Moi, je me concentrer sur la version 1.2.1 !

une page sur le wiki a été créée :
http://langagelinotte.free.fr/wiki/inde ... iel_du_sdz


vous avez un message sur le sdz , pour devenir éditeurs du big tuto "Apprenez à programmer en Linotte"

Bon, on va commencer par le début :p. Je ne peux pas m'occuper du 1) car je n'y connais pas grand chose, mais je peux me charger du 2) pour Windows, Debian/Ubuntu, pourquoi pas mandriva en machine virtuelle, la framakey, mais ça ferait peut-être trop. Peut être vaut il mieux s'en tenir au principaux OS ? (Pour OS X, je n'en ai pas, donc je ne peux pas "tutoriser" l’installation sur cette plateforme.)

Autre question : Vu qu'a peut près tout dans linotte est libre, il ne serait pas mieux de mettre le tuto' en Creative Commons (avec les options ou pas) ?

j'ai changé la licence !

je vais m'occuper du 1).

moi non-plus, je n'ai pas de macOS X.
si tu peux faire pour windows, pour debian et ubuntu c'est déja pas mal, je pense.

je veux bien faire d'autres chapitres de la premiere partie
dis ceux que tu préfere faire.
je veux bien faire le chapitre sur les espèces, et du coup
est-ce que ça te dirait de faire le reste de la partie sur le graphisme?
après je peux m'occuper de la 3eme partie.

y a-t-il des chapitres que tu as envie de faire ou que tu ne voudrais pas faire ?

Des chapitres sur le graphisme, pourquoi pas, mais il faut que je comprenne les espèces et apprennent d'abord. On est pas limiter dans le temps, donc on est pépère, mais il faudra confirmer que je bosse le sujet :p.

Je peuxfaire la plupart des trucs du I/, mise à part les boucles que j'ai du mal à faire marcher, il faudra donc vérifier que je ne raconte pas trop de bêtises si je m'en charge (je sais, je suis un peu long à assimiler, mais ça vient, ça vient !).

Pour la troisième partie, je veux bien que tu t'en occupe, je ne connais aucun des thermes abordés.

Je vais commencer le I/2) dans mon coin déjà, voir comment tu met en forme tes sous parties, puis m'en inspirer !

Après, je te laisse choisir, assigne moi les sous parties que tu veux, je ferais de mon mieux !

non, tant pis, je vais faire la 2eme et la 3eme partie.
je ferai les boucles aussi
je te laisse donc faire la première partie (excepté le I.1 )

donc si on résume, tu fais tout le I sauf I.1 et I.8
et moi je fais I.1 , I.8 et le II et le III.

est-ce que ça marche ?


pour ma part j'aimerais bien finir avant le mois d'aout. car je pars en vac au mois d'aout et après il va y avoir la rentré et j'aurai plus trop de temps à consacrer à linotte " title="Smile" />

Ok, mais si tu trouves que tu as trop, n'hésite pas à me donner des choses à faire !


Tu pense qu'il faut indiquer que le tuto est fait pour la version 1.2, et le blabla qui va avec ?

LawNasK, essaye pour l'instant de faire un seul chapitre si tu n'es pas encore à l’aise en programmation Linotte, ça viendra en même temps " title="Smile" />
Quand tu en as terminé un, tu choisiras le suivant en fonctions des notions que tu auras apprises.

Dés que j'aurai terminé la version 1.2.1, je viendrai vous rejoindre même si j’ai bien l’approche d’un tuto écrit par des personnes « tiers » Vous serez surement plus précis et pédagogue que moi.

D'ailleurs, si d'autres personnes souhaitent les aider...

Ronan, est-ce qu'il serait possible d'avoir l'image suivante sans la grosse barre en bas, et sans les petits dessins à droite, pour l'utiliser comme icône du chapitre I/2) ?

[url=http:
//pix.
toile-libre.
org/?img=1277803768.
png:3ses2zzs][/url:3ses2zzs]

Edit : autre question : à quoi sert "L’exécution des processus externes" à l'étape 7/9 de l'installation Windows ?

Merci ! Je vais la mettre tout de suite " title="Smile" />.

Et pour "L’exécution des processus externes" à l'étape 7/9 de l'installation Windows, de quoi s'agit-il ?

Sinon, $imon, j'ai vu que tu as déjà presque finis le début. Juste une chose à dire : bravo !



Question : est-ce que dans le tutoriel, on aborde Jinotte ou la possibilité d'utiliser Linotte dans les pages internet ?

Edit : En fait, je ne la met pas en icône, $imon a déjà mis un icône à la place, mais je vais le mettre dans le tuto quand même (je la trouve très belle, cette image ...).

On devrait, je pense, mettre au moins le nom de Ronan dans la présentation du langage, car c'est grâce à lui qu'on peux l'utiliser !

La voici !

oui, tout à fait, je n'ai pas encore fini la 3eme partie. Je vais le rajouter.
et pour l'icone, tu peux le changer si tu veux.


Ronan, n' hésite pas à nous corriger si tu voie des erreurs dans le tuto !

Je viens d'y jeter un coup d'oeil ! c'est vraiment sympa, je vais le relire plus tranquillement ce soir.
Je ne l'avais pas encore lu car je surveillais l'ancien tuto sur le site du séro...

Petite question, encore :

À quoi sert Édition/Afficher le message ?