Réflexions sur la documentation

Widow bossera ce week-end sur ton tuto Wam x)

dur dur d'être d'accord avec tout le monde :

https://linuxfr.org/forums/programmatio ... nt-1399695

Pour ça que j'ai ajouté la section Informatique vs Mathématiques dans mon tuto ^^
Mais est-ce suffisamment explicite ?

Sinon la logique serait effectivement de remplacer = par <
-
Comme expliquer ici :

http://www.pise.info/algo/variables.htm

Et puis sa permettrait d'avoir un seul raccourci pour le verbe valoir :;
):


PS : Je compte sur toi, Widow :;
):

La condition suivante n'existe plus ?

si ? est (vrai/faux) ,...

Le tutoriel est passé en version 1.99.7 !

J'ai également ajouté deux chapitres qui viennent clôturer cette première partie sur les notions de base du Linotte.

[attachment=66]

Salut,
Je fais le tuto de Wam , que je trouve excellent, et je suis là pour donner mon avis à cause de pressions externes au forum. Autant j'avais trouvé la première partie excellente, autant je trouve la deuxième moins attirante à mon goût , la partie des "sous-paragraphes" est difficile à comprendre, et il y a des fautes d'orthographe ! Bref sinon bon courage, je continue de lire tes tutos et je continuerai de donner mon avis ici.

++

Wam,

Dans la nouvelle documentation, je nommerai les sous-paragraphes : blocs.
Je pense que c'est plus facile à comprendre.

Cpc

Merci pour tes remarques Widow.

J'ai améliorer le chapitre sur les conditions :

[attachment=68]


En ce qui concerne les fautes d'orthographes, n'hésitez pas à me les indiquer ^^


Pour le choix du vocabulaire, la question se pose pour 3 termes :

Les paragraphes ou les fonctions ?
Dans le verbier, ils sont appelés fonctions.

Les sous-paragraphes ou les blocs ?
Dans le verbier, ils sont appelés blocs.

Les acteurs, que j'ai remplacé par les variables.
Les mots Rôles et Actions ayant disparus et n'utilisant pas un vocabulaire issu du cinéma ou du théâtre dans mon tutoriel, j'ai remplacé le mot acteur.
Peut-être faudrait-il lui trouver un nouveau nom ?

Peut-être qu'il serait bien d'ajouter un petit chapitre sur le verbe "déboguer" ?
C'est une fonctionnalité intéressante pour un débutant.

Dans le sommaire du tuto SDZ de $imon, le débogage est abordé dans la 3ème partie : programmation avancé.

Je comptais donc suivre le même schéma ^^

vivement la suite du document...

Oui, je fait une grande pause ^^
Faut que je m'y remette... xD

Quoi ! " title="Big Grin" />

Je compte sur ton tuto pour présenter la version 2.0 ... mais je ne veux pas te mettre la pression .... hahahaha

Je pense sortir la version 2.0 d'ici quelques jours en fait. dans 1 à 2 semaines.
Ensuite, je vais bosser sur un nouveau greffon pour gérer le réseau.

La version 2.0 est sortie !

Bravo à Cpc !

Du coup, je me devais de passer mon tutoriel en 2.0 ^^

Voici donc la suite avec l'ajout d'un chapitre sur les espèces.

Bonne lecture.

[attachment=69]

Voici la suite de mon tuto !

J'ai commencé la partie sur les notions avancées du Linotte.

J'ai également ajouté un petit paragraphe sur les variables particulières dans le chapitre sur les drapeaux.
Ce paragraphe sera susceptible de changer de place par la suite.

Bonne lecture !

[attachment=85]

Bravo !
C'est une version que je peux commencer à mettre dans la section "Documentation" du site Internet.
Mais auparavant, il y a quelques fautes : des "sa" au lieu de "ça" et quelques autres.
Chapitre : "Voici les fonctions mathématiques disponibles", peux-tu remplacer les = par vaut ?

Rien de méchant, ça se corrige vite !

Dès que tu as une version corrigée, je la dépose sur le site.
Encore bravo pour ce travail !

Cpc

Il existe le verbe Insérer qui permet d'ajouter un acteur dans un tableau à une position N.

Merci.

Je vais donc ajouter le verbe Insérer.

Pour les fautes d'orthographe, c'est très difficile pour moi de les repérer, car, quand on se relis, on ne fait que survoler son texte et même les fautes les plus flagrantes nous échappent. C'est beaucoup plus facile de corriger les fautes d'un texte qui n'est pas le sien.
Donc, si vous avez le temps, n'hésitez pas à me les indiquer précisément ^^

Pour ce qui est de publier le tuto sur le site, je considère qu'il n'est pas encore prêt.
En effet, pour reprendre les termes de Cpc, le tuto est pour l'instant une sorte de laboratoire ;
p
Je ne suis pas encore fixé sur le plan général du tuto.

Pour exemple, j'ai commencé la partie graphique, mais je n'ai pu la terminer car elle nécessite de connaître quelques notions avancées du Linotte.
Pour la partie graphique j'hésite donc entre deux solutions :

1) soit la mettre en troisième partie : du coup je déplacerais sans doute le chapitre sur les espèces, qui me servira d'introduction.

2) soit la couper en deux, comme ceci :
- Les notions de base du Linotte (Partie I)
- Le graphisme (1ère partie) (Partie II)
- Les notions avancées (Partie III)
- Le graphisme (2ème partie) (Partie IV)

La première partie du graphisme permettrais au lecteur de faire une pose avant de poursuivre l'apprentissage sur l'utilisation des variables, fonctions et autres...
De plus, pour ceux que le graphisme intéresse au plus haut point, cela leur éviterais de devoir lire tout le tuto pour enfin pouvoir l'étudier.

Qu'en pensez-vous ?

Je pourrais vous fournir la première partie sur le graphisme, mais il manque encore deux, trois choses, comme l'utilisation de l'espèce parchemin ou les formats supportés par l'espèce graphique...

Bonsoir,

Pour les fautes, je comprends tout à fait.
Il est difficile d'avoir le recul nécessaire quand on a le nez dedans !

Je ferai un retour plus précis dans la semaine.

Pour l'ordre des chapitres, tu peux présenter les espèces graphiques comme indiqué dans ton point 2. Il est bien de présenter un peu de commandes de base, puis un peu de graphisme puis enfin pousser les choses plus loins !
Le plus compliqué avec le graphisme est la notion d'évènement. Le reste n'est qu'une question d'imagination....

J'attendrai ton feu vert pour le mettre sur le site !

Pour le parchemin et les autres questions, je répondrai plus tard... j'ai besoin, moi aussi, de réviser mes bases :-)
En fait, je sais que le parchemin permet de mettre du texte sur plusieurs lignes, chose que ne sait pas faire le graffiti, mais je crois qu'il y a d'autres différences...

Cpc

page 4 :
-L'éditeur de greffons. Les greffons ont pour but d'enrichir le Linotte à partir de programmes écrits dans d'autres langages
- ce menu se compose de cinq parties

page 6 :
En effet, à l'image d'un livre, ceci va permettre de structurer votre code en fonctions

page 15 :
remplacer les "=" par "vaut"

page 17 :
Le verbe Afficher est particulié
sans utiliser de variable

page 19 :
On a également

Page 21 :
ça fonctionne
Mais ça ne répond

Page 22 :
Et si je fais ceci ?

Page 25 :
vous les trouverez bien utiles

Page 28 :
Peu importe

Page 35 :
Peu importe
Voyons voir ce que ça donne

Page 36 :
La boucle ayant effectuée

Page 40 :
voici ce que ça donne

Page 48 :
nous avons créé

Page 49 :
Chaque variable d'une espèce est appelée attribut

Page 50 :
En effet, la section Espèces doit se trouver avant la première fonction

Page 55 :
Mais ça ne résout pas notre problème

Page 56 :
Vous n'êtes pas obligé

Page 57 :
ça fonctionne !

Page 59 :
Voyons voir ce que ça donne
Mais... Mais... ça fonctionne !

Je viens de remarquer une erreur dans le chapitre sur la portée des variables, page 57

"En utilisant le verbe Parcourir, si on quitte la fonction, et que l'on y revient ensuite, la valeur de la
variable reviens à sa valeur initiale. Elle n'est pas sauvegardée."

en fait la valeur revient à 3 du fait que l'on utilise l'action "var vers exemple 1" dans la fonction Exemple 2 : ce qui va réexécuter "nombre1 est un nombre valant 3"

N'est-ce pas un chapitre difficile pour les débutants ?
La première partie est très bien sur la portée des variables globales.
Pour la seconde partie, il faut se limiter à la portée des variables locales dans une fonction et ensuite les paramètres comme tu as fait.

La bonne pratique est d'utiliser le verbe parcourir avec le verbe revenir ou retourner.

Bravo encore pour ton travail ! Ce travail est très interessant, notamment sur la portée des variables

Merci pour ces retours !

deux remarques cependant :

- particulier s'écrit bien "particulier"

- A la page 6 ma phrase signifie : En effet, à l'image d'un livre, ceci va permettre de structurer votre code comme des paragraphes.


Pour le verbe parcourir :

Très bonne remarque !

Le problème c'est qu'en Linotte on peut faire ceci :

[php]
Exemple1 :
nombre1 est un nombre
début
Affiche nombre1
nombre1 vaut 6
Parcours Exemple2

Exemple2 :
début
Affiche nombre1
nombre1 vaut 5
Affiche nombre1
Va vers Exemple3

Exemple3 :
début
Affiche nombre1
[/php]

En quoi ce code constitue une erreur ?

Pourquoi doit-on obligatoirement associer le verbe Parcourir au verbe Revenir ?

ça permet d'éviter ça :
http://fr.wikipedia.org/wiki/Programmation_spaghetti

Il vaut mieux commencer avec les bonnes bases !

Je viens également de tester le verbe "insérer" afin de le rajouter dans le tuto.
Le problème c'est que j'explique justement au lecteur que la numérotation des casiers commencent à partir de 0.
Or, le verbe insérer commence sa numérotation à 1.
Du coup, ça ne facilite pas la compréhension du chapitre...

Ton tuto m'emmène a réfléchir sur la portée des variables dans une fonction.

La plupart des langages fonctionnent ainsi :

- Les variables créées dans une fonction F ne sont visibles que dans la fonction F.

Mais en javascript, une variable créée dans une fonction F sera visible dans toutes les fonctions appelées à partir de cette fonction F : ( http://jpvincent.developpez.com/tutorie ... script/#L2 )

Linotte 2.0.1 fonctionne ainsi. C'est possible car Linotte fonctionne avec une pile FIFO sur laquelle je pose les appels de fonctions.
Quand je cherche une variable, je descends la pile du haut vers la bas pour retrouver ma variable.

La question que je me pose... Est-ce une bonne idée ?Est-ce que ça ne complique pas la compréhension de son programme ?