Alors que Cpc travaille activement à l'élaboration du Linotte 2.0, j'aimerais me pencher sur : la documentation !
En effet, avec l'arrivée prochaine de cette nouvelle syntaxe, se serait l'occasion de rafraîchir la documentation de notre cher langage.
Faisons le tour de tous les outils d'apprentissage déjà mis à disposition.
On trouve :
1) le manuel de référence "Découvrir la programmation avec le langage Linotte"
2) découvrir Linotte en 10 et 20 minutes
3) le verbier
4) la boite à espèces (nouveauté !)
5) les exemples
On remarque que Cpc n'a pas lésiné sur les moyens de faire découvrir son langage !
Voyons maintenant comment on pourrait les améliorer :
1) le manuel de référence :
- à convertir en syntaxe 2.0, évidemment (on souhaite bon courage à Cpc :;
): )
- afficher le lien vers le manuel directement sur la page d’accueil du site. Je le verrais bien sous un onglet "Pour programmeurs débutants".
2) découvrir Linotte en 10 et 20 minutes :
- très pratique ! A convertir en syntaxe 2.0 (on pourrait peut-être réécrire les exemples dans un post dédié, cela permettrait à Cpc d'avoir juste à les copier/coller...)
- afficher le lien sur la page d’accueil du site, sous un onglet "Pour programmeurs confirmés", en guise d'avertissement.
Viennent ensuite les outils intégrés à l'atelier :
3 ) le verbier :
- ajouter une infobulle sur chaque espèces, expliquant en quelques mots à quoi ils servent. Je pense surtout aux élément d'IHM : on ne sait pas forcément ce qu'est une étiquette ou même un formulaire ! Et se serait plus utile que l'infobulle "Espèce de l'interface Swing Utilisateur Linotte" affiché actuellement.
4) la boite à espèces :
- fait doublon au verbier ?
5) les exemples :
- réorganiser et renommer les exemples : le principal problème des exemples est qu'on ignore ce qu'ils contiennent. Combien de fois j'ai créer un post sur le forum car je n'arrivais pas à faire quelque chose, et Cpc m'a alors indiqué l'exemple où se trouvait la solution ? Car des exemples, il y en a beaucoup, et on a pas forcément envie de tous les lire. Ce qu'on voudrait, c'est lorsque l'on est bloqué, on sache que tel exemple puisse nous aider.
Ces trois outils sont essentiels mais, pour augmenter leur efficacité, il faudrait arriver à les relier entre eux.
Voici mon idée :
Elle consisterait à améliorer le verbier.
Lorsque l'on sélectionne une espèce, il faudrait qu'elle affiche non seulement les fonctions (ce qui est déjà le cas), mais également les caractéristiques.
Et devant chaque caractéristiques, il y aurait une case à cocher.
Ainsi, on pourrait choisir directement les caractéristiques à afficher sur le cahier. Car lorsque l'on sélectionne l'espèce "champ" dans le verbier, voici ce qui s'affiche :
[php]
? :: champ, infobulle vaut ?, mode vaut ?, taille vaut 15, texte vaut ?, visible vaut "oui", x vaut 0, y vaut 0
[/php]
Or, on n'a pas forcément besoin de l'infobulle, ni de mettre visible à "non". Du coup, ça nous oblige à les effacer pour n'avoir que l'essentiel, généralement :
[php]
? :: champ, taille vaut 15, x vaut 0, y vaut 0
[/php]
On gagnerait alors en simplicité.
De plus, le fait d'afficher les caractéristiques dans le verbier leur permettrais d'avoir leur propre infobulle, décrivant en quelques mots leur utilité !
Ainsi, le verbier et la boite à espèce ne ferait plus qu'un.
Enfin, pour certains verbes ou espèces, on pourrait ajouter un onglet "exemple", indiquant un exemple où il est utilisé.
Ainsi, en allant dans le verbier, on aurait tous les verbes et espèces existants, avec une infobulle expliquant à quoi ils servent, toutes leurs caractéristiques sélectionnables avant de les afficher sur le cahier, et même un exemple expliquant leur fonctionnement.
Évidemment, il conviendrait de réorganiser le verbier pour éviter qu'il ne soit trop surchargé, et donc illisible.
Plusieurs solutions sont envisageables, par exemple :
- les problèmes de navigation et de lisibilité des sous-menus interviennent surtout quand ces derniers se superposent. Il faudrait donc désactiver et griser les menus pour afficher seulement celui qui est sélectionné, ou encore changer la couleur du menu et de ses sous-menus pour les mettre en évidence.
- le verbier pourrait s'afficher dans une fenêtre, à l'instar du manageur de styles.
...
Comme vous l'aurez peut-être déjà remarqué, je suis toujours pour tout regrouper, tout centraliser au même endroit. (Je ne comprend toujours pas pourquoi, quand on créer un favori, il ne s'intègre pas directement dans l’arborescence du sommaire ^^)
L'idée est donc de faire du verbier THE outil indispensable regroupant tous les outils disséminés autour du cahier.
Évidemment, cela ne correspond pas forcément a votre vision des choses. Il vaudrait alors mieux que tout soit bien espacé à gauche, en haut et à droite de l'atelier, pour être sûr que tout soit bien aéré et lisible.
Néanmoins, je pense qu'il faudrait arriver à relier le verbier, la boite à espèces et les exemples entre eux, pour gagner en efficacité.
Qu'en pensez-vous ?
A vos idées !
En effet, avec l'arrivée prochaine de cette nouvelle syntaxe, se serait l'occasion de rafraîchir la documentation de notre cher langage.
Faisons le tour de tous les outils d'apprentissage déjà mis à disposition.
On trouve :
1) le manuel de référence "Découvrir la programmation avec le langage Linotte"
2) découvrir Linotte en 10 et 20 minutes
3) le verbier
4) la boite à espèces (nouveauté !)
5) les exemples
On remarque que Cpc n'a pas lésiné sur les moyens de faire découvrir son langage !
Voyons maintenant comment on pourrait les améliorer :
1) le manuel de référence :
- à convertir en syntaxe 2.0, évidemment (on souhaite bon courage à Cpc :;
): )
- afficher le lien vers le manuel directement sur la page d’accueil du site. Je le verrais bien sous un onglet "Pour programmeurs débutants".
2) découvrir Linotte en 10 et 20 minutes :
- très pratique ! A convertir en syntaxe 2.0 (on pourrait peut-être réécrire les exemples dans un post dédié, cela permettrait à Cpc d'avoir juste à les copier/coller...)
- afficher le lien sur la page d’accueil du site, sous un onglet "Pour programmeurs confirmés", en guise d'avertissement.
Viennent ensuite les outils intégrés à l'atelier :
3 ) le verbier :
- ajouter une infobulle sur chaque espèces, expliquant en quelques mots à quoi ils servent. Je pense surtout aux élément d'IHM : on ne sait pas forcément ce qu'est une étiquette ou même un formulaire ! Et se serait plus utile que l'infobulle "Espèce de l'interface Swing Utilisateur Linotte" affiché actuellement.
4) la boite à espèces :
- fait doublon au verbier ?
5) les exemples :
- réorganiser et renommer les exemples : le principal problème des exemples est qu'on ignore ce qu'ils contiennent. Combien de fois j'ai créer un post sur le forum car je n'arrivais pas à faire quelque chose, et Cpc m'a alors indiqué l'exemple où se trouvait la solution ? Car des exemples, il y en a beaucoup, et on a pas forcément envie de tous les lire. Ce qu'on voudrait, c'est lorsque l'on est bloqué, on sache que tel exemple puisse nous aider.
Ces trois outils sont essentiels mais, pour augmenter leur efficacité, il faudrait arriver à les relier entre eux.
Voici mon idée :
Elle consisterait à améliorer le verbier.
Lorsque l'on sélectionne une espèce, il faudrait qu'elle affiche non seulement les fonctions (ce qui est déjà le cas), mais également les caractéristiques.
Et devant chaque caractéristiques, il y aurait une case à cocher.
Ainsi, on pourrait choisir directement les caractéristiques à afficher sur le cahier. Car lorsque l'on sélectionne l'espèce "champ" dans le verbier, voici ce qui s'affiche :
[php]
? :: champ, infobulle vaut ?, mode vaut ?, taille vaut 15, texte vaut ?, visible vaut "oui", x vaut 0, y vaut 0
[/php]
Or, on n'a pas forcément besoin de l'infobulle, ni de mettre visible à "non". Du coup, ça nous oblige à les effacer pour n'avoir que l'essentiel, généralement :
[php]
? :: champ, taille vaut 15, x vaut 0, y vaut 0
[/php]
On gagnerait alors en simplicité.
De plus, le fait d'afficher les caractéristiques dans le verbier leur permettrais d'avoir leur propre infobulle, décrivant en quelques mots leur utilité !
Ainsi, le verbier et la boite à espèce ne ferait plus qu'un.
Enfin, pour certains verbes ou espèces, on pourrait ajouter un onglet "exemple", indiquant un exemple où il est utilisé.
Ainsi, en allant dans le verbier, on aurait tous les verbes et espèces existants, avec une infobulle expliquant à quoi ils servent, toutes leurs caractéristiques sélectionnables avant de les afficher sur le cahier, et même un exemple expliquant leur fonctionnement.
Évidemment, il conviendrait de réorganiser le verbier pour éviter qu'il ne soit trop surchargé, et donc illisible.
Plusieurs solutions sont envisageables, par exemple :
- les problèmes de navigation et de lisibilité des sous-menus interviennent surtout quand ces derniers se superposent. Il faudrait donc désactiver et griser les menus pour afficher seulement celui qui est sélectionné, ou encore changer la couleur du menu et de ses sous-menus pour les mettre en évidence.
- le verbier pourrait s'afficher dans une fenêtre, à l'instar du manageur de styles.
...
Comme vous l'aurez peut-être déjà remarqué, je suis toujours pour tout regrouper, tout centraliser au même endroit. (Je ne comprend toujours pas pourquoi, quand on créer un favori, il ne s'intègre pas directement dans l’arborescence du sommaire ^^)
L'idée est donc de faire du verbier THE outil indispensable regroupant tous les outils disséminés autour du cahier.
Évidemment, cela ne correspond pas forcément a votre vision des choses. Il vaudrait alors mieux que tout soit bien espacé à gauche, en haut et à droite de l'atelier, pour être sûr que tout soit bien aéré et lisible.
Néanmoins, je pense qu'il faudrait arriver à relier le verbier, la boite à espèces et les exemples entre eux, pour gagner en efficacité.
Qu'en pensez-vous ?
A vos idées !
Suppression des articles : Pour et Contre : Contre, nuit à la lisibilité du langage. Pour, en dehors de la lisibilité, est inutile au langage.