Gambas France BETA


Pas de compte ? Incription

Refonte de l'aide Gambas...

12
AuteurMessages
spheris#1 Posté le 16/4/2022 à 06:24:36
Bonsoir à tous,
Ce titre accrocheur est tellement qu'on pourrait presque vendre tous les stocks, héhé.
;)

L'analyse de la documentation officielle wiki semble poser des soucis à certains.

voir ici

Quel sont à votre avis les points noirs de cette documentation?

Que pourrait-on faire pour l'améliorer?

Pensez-vous qu'une documentation collaborative pourrait être la solution? (exemple un wiki multi-utilisateurs.

Merci pour vos réponses.
spheris#2 Posté le 16/4/2022 à 06:27:27
Je poursuis la discussion de jean Yvon ici.

Pour ma part, le problème c'est qu'elle soit incomplète.
C'est ce qui me pose le plus de soucis.
En effet, si je veux utiliser par exemple une moviebox sous gb3.14, c'est la catastrophe.
Non seulement la documentation est lunaire, mais en plus ce composant ne fonctionne pas du tout en liaison avec la doc.

Dans l'absolue, il faudrait que la documentation affichée corresponde à la version de gambas sur le PC qui fait appel à l'aide.
valaquarus#3 Posté le 16/4/2022 à 12:00:51
-- Unus Ex Altera --Bonjour Sphéris,
je vois deux options :
- un échange collaboratif avec l'auteur qui valide et corrige nos propositions. Ce qui va lui demander un travail fou supplémentaire.
- chacun peut pondre un article sur un élément de programmation qu'il a "subit" et avec lequel il a due se confronter sans ou avec solution.

J'opterai pour la deuxième solution mais il faut un endroit collaboratif où tout ranger et là j'ai une petite idée car c'est ce que tu as déjà fais avec ton site que tu as nommé "site d'aide aux utilisateurs de gambas". Tu as déjà bien dégrossi le problème mais il ne faut pas que cela devienne une corvée pour toi donc une page genre wiki multi-user est semble-t-il la solution.
Philippe
Système d'exploitation : KDE neon 6.0 ~ Version Gambas : 3.19.3
jeanyvon#4 Posté le 22/4/2022 à 11:34:20
Gambas? Ma! Et gustoSalut à tous!
Oui, ça me parait long et dur de demander à un auteur de rectifier son œuvre même s'il s'agit d'une aide.
En deux, je ne me sens pas qualifié pour écrire un article sur un composant dont je ne connais que peu de chose et que je n'utilise peut être pas comme il a été prévu de le faire.
Je pense que ce qu'il faut pour moi, c'est supprimer la petite phrase : la page en anglais est plus à jour...
la traduction par n'importe traducteur est d'une qualité que je n'apprécie pas.....
Vieillir? On peut retarder mais pas y échapper!
valaquarus#5 Posté le 22/4/2022 à 14:12:29
-- Unus Ex Altera --Bonjour JeanYvon,
une des idées serait justement de transmettre aux autres ce que tu as subit et vécu en utilisant un composant ou autre d'une manière que tu croyais juste pour t'apercevoir des limites que tu as induites avec cette manière de l'utiliser. Pour ce qui est de la traduction, nous sommes sur le même point de vue même si je maîtrise "pas mal" la langue anglaise, j'avoue que communiquer en anglais avec Benoît pour ne pas "froisser" le reste de la planète me gonfle assez (après tout il n'ont qu'a faire l'effort, eux de parler français ou de traduire dans leur langue, la notre. Mais ce n'est pas le choix de Benoît et il est respectable mais gonflant.
Philippe.
Système d'exploitation : KDE neon 6.0 ~ Version Gambas : 3.19.3
spheris#6 Posté le 27/4/2022 à 06:31:44
Ce qui me dérange fortement c'est que la doc appelée par l'IDE gambas (quand je clique sur le menu aide en ligne) ne pointe pas version la version utilisée sur mon ordinateur mais uniquement la dernière version générique. Ainsi, cette aide la plupart du temps ne fonctionne pas et ne sert pas à grand chose lors d'une incompréhension de telle ou telle fonction.

...alors la solution est d'essayer des trucs, des combinaisons avec parenthèses, crochets, point,etc... et là je découvre d'autres choses intéressantes.
valaquarus#7 Posté le 5/5/2022 à 15:22:16
-- Unus Ex Altera --Bonjour spheris,
normalement dans l'IDE de gambas tu peux régler le choix de télécharger la dernière version de l'aide soit d'utiliser la version en cours sur ton installation. Aller dans le menu Outils, Préférences et régler l'aide.
Philippe
Système d'exploitation : KDE neon 6.0 ~ Version Gambas : 3.19.3
jeanyvon#8 Posté le 6/5/2022 à 10:03:35
Gambas? Ma! Et gustoHello
Décidément, l'aide fournie par ce forum est vraiment, vraiment top!
Je ne sais pas si gambix qui doit en être le proprio voudrait nous céder la main pour regroupement des sujets et leurs tris. Avec une entrée non plus par sujet mais par mot-clef. ça éviterait un sacré boulot!
Vieillir? On peut retarder mais pas y échapper!
valaquarus#9 Posté le 6/5/2022 à 13:43:08
-- Unus Ex Altera --Oui jeanyvon,
Gambix a tout remis d'équerre sur ce site, un grand merci à lui.
Si nous l'animons simplement et joyeusement, il repassera à pas feutrés nous donner un coup de main en cas de nécessité.
Philippe
Avec une entrée non plus par sujet mais par mot-clef. ça éviterait un sacré boulot!

Qu'entends tu par là?
Système d'exploitation : KDE neon 6.0 ~ Version Gambas : 3.19.3
jeanyvon#10 Posté le 6/5/2022 à 14:51:09
Gambas? Ma! Et gustoRe!
Je trouve la disposition des mots-clef (if, then, ect....) dans l'aide de Gambas assez bien faite, ce qui me manque c'est de savoir quel composant donne accès à tel ou tel mot du langage.
Ici (dans le forum) les entrée sont par sujet traité, c'est compliqué de savoir quel mot-clef est utilisé dans tel sujet.
Parce que, y a pas de pétard, ce sont les exemples qui nous disent comment se servir des mots-clef. Et nous ici on ne fait que ça donner des exemples. Comme en plus nous testons les codes que les membres postent: ça devient du sérieux!
Vieillir? On peut retarder mais pas y échapper!
valaquarus#11 Posté le 6/5/2022 à 15:21:15
-- Unus Ex Altera --jeanyvon,
je te propose de définir une sorte de page (pas besoin d'une page html mais un fichier texte simple) avec les mots clef dont tu parles, de nous l'envoyer pour que nous puissions en faire un début de quelque chose.
Il y a tellement de "mots clef" qu'à priori cela me semble énorme mais une brique après l'autre permet de construire.
Philippe
Système d'exploitation : KDE neon 6.0 ~ Version Gambas : 3.19.3
jeanyvon#12 Posté le 7/5/2022 à 13:07:53
Gambas? Ma! Et gusto
jeanyvon,
je te propose de définir une sorte de page (pas besoin d'une page html
Philippe


Bonjour!
Je me lance et je passe les pages d’accueil:
La page du langage du wiki me va bien.
Premier item de la liste : abs
la page de ce mot-clef me semble parfaite : Les exemples sont claires, en nombre suffisant

Mais pour ce mot-clef c'est simple, pour d'autre ça sera beaucoup complexe. Il me semble, qu'il ne faut pas casser ce qui a le mérite d’être fait.
Comment pouvoir inter-agir? Sur quel support travailler?
Vieillir? On peut retarder mais pas y échapper!
valaquarus#13 Posté le 7/5/2022 à 15:33:18
-- Unus Ex Altera --
Je poursuis la discussion de jean Yvon ici.

Pour ma part, le problème c'est qu'elle soit incomplète.
C'est ce qui me pose le plus de soucis.
En effet, si je veux utiliser par exemple une moviebox sous gb3.14, c'est la catastrophe.
Non seulement la documentation est lunaire, mais en plus ce composant ne fonctionne pas du tout en liaison avec la doc.

Dans l'absolue, il faudrait que la documentation affichée corresponde à la version de gambas sur le PC qui fait appel à l'aide.


Spheris, connaissant ton aversion pour qt, je te rappelle que ce composant (moviebox) est QT4, voir ici: http://gambaswiki.org/wiki/comp/gb.qt4/moviebox
et donc si tu l'utilises sans tout ce qui va avec, normal que cela plante.
Philippe
P.S.: je me moque mais c'est vrai que la documentation est au minimum descriptive mais guère plus.
Système d'exploitation : KDE neon 6.0 ~ Version Gambas : 3.19.3
spheris#14 Posté le 8/5/2022 à 08:39:01
JY,
Je te confirme que la page ABS est complète et utilisable comme aide.
deux petits idées cependant :

-la possibilité de mettre à la fin de cette page des liens internets sur des programmes, pages ou endroits ou ABS est utilisé.
- un bouton COPIER qui permettrait de récupérer un bout de code, très utile lorsqu'on a besoin de réutiliser le code directement dans l'IDE.


valaquarus,
Mon aversion à qt n'est pas si horrible que cela. Ce qui m'a toujours géné, c'est la bascule d'une version à l'autre. un coup cela marche un coup cela ne marche pas.
Pareil pour du gtk 2 vers 3.

le gtk2 ayant encore beaucoup d'avenir devant lui, tous mes progs seront compatibles durant une ou deux décénis, le temps de la retraite , héhé.
valaquarus#15 Posté le 10/5/2022 à 13:14:40
-- Unus Ex Altera --Bonjour spheris, jeanyvon
j'ai commencé un début de refonte du wiki : Wiki
Voir le dernier lien en bas
J'ai aussi mis à jour pas mal de lien (pas encore tous) qui tombaient dans le vide ou qui pointaient vers des pages vides.
Spheris, je voulais d'abord obtenir ton autorisation pour récupérer certains exemples de ton site pour les intégrer dans ce wiki ou te laisser faire toi même ces changements, soit par des liens (mais c'est pas beau ) soit par la création d'une nouvelle page pour chaque nouvel exemple.
J'aimerai quelques commentaires sur ce que j'ai déjà fait pour corriger, modifier, annuler ou tout autre chose.
Philippe
Système d'exploitation : KDE neon 6.0 ~ Version Gambas : 3.19.3
12