JabberFR:Accueil
Merci de l'intérêt que vous portez à ce projet de documentation libre sur Jabber.
L'objectif de cette page est de vous indiquer clairement comment bien y participer.
Nouveau sur le wiki
Une des règles essentielles, est qu'il ne faut pas hésiter à modifier le wiki. En effet, c'est grâce à vos contributions que la qualité et le nombre d'information disponible sur le wiki peuvent aller de l'avant.
Par où commencer ?
Le plus simple au début, c'est d'aller sur les pages des clients jabber que l'on utilise, et de relire ces articles.
N'y a-t-il pas de fautes dans l'article ? Le numéro de version indiqué tient-il compte de la dernière version sortie la semaine dernière ? La licence est-elle correcte ? Le logiciel ne tourne-t-il que sous GNU/Linux ? La description est-elle exacte ?
Ce sont les questions courantes à se poser lorsque l'on débarque sur un article que l'on n'a jamais relu auparavant.
Ensuite
Une fois que vous aurez un peu pris vos marques, vous pourrez vous lancer à corps perdu dans la documentation de la syntaxe de mediawiki, le logiciel faisant tourner ce site.
Par la suite, vous voudrez sûrement sortir du cocon d'articles que vous améliorez sans cesse jour après jour ;) Pour trouver d'autres proies, n'hésitez pas à consulter les différentes listes :
- pages en chantier : ayant peu ou pas de contenu, il faut les compléter le plus que possible
- page en traduction : page ayant besoin d'être traduite en français et nécessitant une relecture
- pages en impasse : une fois que l'on arrive dessus, on ne peut plus aller de l'avant ; regarder si vous ne pouvez pas faire un lien interne sur les différents mots présents dans l'article
- pages sans catégorie : consultez la liste des catégories, et catégorisez ces articles
- pages les plus demandées : d'autres articles font référence à ces pages qui n'existent pas encore ; créez les ;)
Vous pouvez aussi consulter :
- les articles les moins modifiés : s'ils n'ont pas été modifié beaucoup, c'est soit qu'ils sont incomplets, soit qu'ils sont truffés de fautes
- les articles les moins récemment modifiés : plus la date de dernière modification est loin dans le temps, et plus il y a de chance que l'article ne soit plus du tout au goût du jour
- les dernières modifications : peut-être est-ce du vandalisme, ou bien une modification non justifiéek, ou bien encore la personne a peut-être fait une faute dans ce qu'elle a modifié
- les pages les plus consultées : ces pages méritent une attention toute particulière ; en effet, c'est par l'une de ces pages qu'un nouvel arrivant risque de débarquer, il faut donc lui donner bonne impression en ne négligeant surtout pas la présentation et la qualité de ces pages
- les redirections cassées : une page redirige vers une autre qui n'existe plus ! essayez de réparer cette redirection cassée
- une page au hasard : c'est en effet le meilleur moyen de tomber sur une page qui nous est encore inconnue, et sur laquelle il y a des choses à faire ;)
Pour aller plus loin
Comme vous l'aurez sans doute remarqué au cours de votre périple, les modèles nous sont d'une grande utilité. ils permettent entre autres d'automatiser un certain nombre de tâches rébarbatives. N'hésitez donc pas à en créer qui puissent nous faciliter encore plus la vie ! :D
Ceci demande toutefois une certaine expérience dans la compréhension et l'utilisation de la syntaxe de mediawiki.
Allez consulter en particulier la documentation de l'extension ParserFunctions (en français) et celle de StringFunctions (en anglais). elles vous seront probablement d'une grande utilité.
La mise en page des articles
Client
Serveur
Bibliothèque
Tutoriel
Les modèles utilisés sur le wiki
Un certain nombre de modèles sont utilisés sur le wiki. Voici une courte introduction pour les plus utiles (ceux avec lesquels vous devraient fatalement traiter à un moment donné).
Pour avoir une documentation plus complète, rendez-vous directement sur la page du modèle en question.
Pour une liste complète des modèles existant sur le wiki, merci de consulter la page spéciale les listant tous.
{{TODO}}
Lorsqu'une page est quasiment vide, ou très incomplète, on utilise ce modèle dessus. Ainsi on peut spécifier aux visiteurs et aux contributeurs que l'article n'est pas complet, et qu'il est nécessaire de le compléter.
{{Traduction}}
On utilise ce modèle sur les pages en cours de traduction d'une langue étrangère vers le français. ainsi, on sait que la traduction de la page n'est pas finie, ou bien qu'elle nécessite une grosse relecture.
{{Logiciel simple}}
Ce modèle s'utilise sur chaque article concernant un client, un serveur, une bibliothèque, ou bien un bot. C'est en quelque sorte une petite fiche descriptive du logiciel en question.
{{en}}, {{es}}, {{fr}} et {{ru}}
Sur certains articles sont listés quelques liens externes pointant soit vers un forum, une documentation, un message sur une liste de diffusion, etc. Pour que le visiteur sache ce qui l'attend s'il suit ce lien, on précise la langue de la page vers laquelle on le dirige. Ainsi, si le visiteur ne connaît pas un mot de russe, il saura que suivre un lien vers un site en russe ne l'aidera pas beaucoup.
{{version}}
Il est utilisé pour spécifier la version des logiciels. Un des gros avantage de ce modèle, est qu'en changeant le numéro de version d'un logiciel apr exemple, ça le change aussi bien sur l'article du logiciel en question, mais aussi sur la page Implémentation (s'il y est présent). Ainsi, on n'a plus qu'à changer le numéro de version et la date de sortie qu'à un seul endroit.
{{Tutoriels client}}
Il est utilisé dans le cadre d'une série d'articles faisant office de tutoriel pour un client donné.
{{Tutoriels serveur}}
Il est utilisé dans le cadre d'une série d'articles faisant office de tutoriel pour un serveur donné.
{{Client_historique}}
Il est utilisé pour les clients dits historique.