Organisation du wiki
#1
Bonjour,

Actuellement, le wiki, reprend a peu prêt le même fonctionnement que wfr, le même principe, en ce qui concerne le détail de chaques fonctions.

Exemple au pif : http://www.eggdrop.fr/Expr

Ont retrouve la même doc que wfr.

A l'ancienne, j'avais proposer non pas la documentation officielle de la fonction, mais plustot des exemples appliquées pour chaques fonctions.
Enfait, j'avais juste mit a disposition la description des fonctions et un ou plusieurs snippets (mini code) disponibles pour mieu comprendre la fonction (un exemple appliqué a l'eggdrop quoi).

Bon, ok, ce n'étais certainement pas très clair.

La, j'aimerai votre avis, mais dans l'idéal, il faudrait reprendre ce système tout en laissant la documentation de la fonction.
(En gros, ont a la doc et exemple appliqué (dans l'idéal, il faudrait bien distingué les deux)).
Cela permettrait d'être bien sur de comprendre le fonctionnement d'une fonction.

J'ai éventuellement une autre idée, et je sollicite votre avis quand a celle-ci.
Une personne qui cherche a faire quelque chose de particulier, mais qui ne sais pas comment faire, et ne connais pas quelle fonction utiliser.
Exemple a la con : Générer un nombre
Bon bah, ok, il y a toujours le forum et la fonction recherche, mais ont peut faire une page qui résume ce qu'on peut trouver sur le wiki, ainsi ceux qui se perdent souvent sur le wiki pourraient mieux ce retrouver.
Exemple de contenu de la page :
- Générer un nombre
- Gestion des fichiers en général
- Récuperer une information sur un site internet
- Envoyer un mail
  Répondre   Avertir
#2
DaV34 a écrit :Actuellement, le wiki, reprend a peu prêt le même fonctionnement que wfr, le même principe, en ce qui concerne le détail de chaques fonctions.
C'est vrai pour le TCL "pur", et ce n'est même pas "à peu près": j'ai demandé l'autorisation de pouvoir copier les pages, je l'ai eue, je le fait.
DaV34 a écrit :A l'ancienne, j'avais proposer non pas la documentation officielle de la fonction, mais plustot des exemples appliquées pour chaques fonctions.
Enfait, j'avais juste mit a disposition la description des fonctions et un ou plusieurs snippets (mini code) disponibles pour mieu comprendre la fonction (un exemple appliqué a l'eggdrop quoi).
La, c'est le principe que je veux appliquer aux "pages de synthèse", comme par exemple Utilisation des listes qui permet d'avoir des exemples pratiques et précis adaptés aux eggdrops.
DaV34 a écrit :J'ai éventuellement une autre idée, et je sollicite votre avis quand a celle-ci.
Une personne qui cherche a faire quelque chose de particulier, mais qui ne sais pas comment faire, et ne connais pas quelle fonction utiliser.
Exemple a la con : Générer un nombre
Bon bah, ok, il y a toujours le forum et la fonction recherche, mais ont peut faire une page qui résume ce qu'on peut trouver sur le wiki, ainsi ceux qui se perdent souvent sur le wiki pourraient mieux ce retrouver.
Là encore, on est dans des tutoriels (manipulation des chiffres?). Ensuite, rien n'empèche de créer des liens de redirection (par exemple la page "Nombre aléatoire" pourrait renvoyer sur "Manipulation des chiffres")

Mais comme je le dis et le redis, il me semble que je sois le seul à mettre la main dans le wiki actuellement (que ce soit pour la copie ou les traductions) donc ça prend du temps et j'essaye de faire les choses au fur et à mesure.
  Répondre   Avertir


Atteindre :


Utilisateur(s) parcourant ce sujet : 1 visiteur(s)