Poster une réponse  Créer un sujet 
Organisation du wiki
Auteur Message
DaV34
Member
***


Messages : 64
Groupe : Registered
Inscription : May 2007
Statut : Hors ligne
Message : #1
Organisation du wiki

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

26/02/2008 14:13
Trouver tous les messages de cet utilisateur Citer ce message dans une réponse
CrazyCat
Administrator
*******


Messages : 1,396
Groupe : Administrators
Inscription : Apr 2004
Statut : Hors ligne
Message : #2
RE: Organisation du wiki

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.


Trucs et astuces en programmation - Je suis actuellement
26/02/2008 14:57
Visiter le site internet de cet utilisateur Trouver tous les messages de cet utilisateur Citer ce message dans une réponse
Poster une réponse  Créer un sujet 

Voir une version imprimable
Envoyer ce sujet à un ami
S'abonner au sujet | Ajouter le sujet aux favoris

Aller à :