PHPBoost CMS

Hello tous les membres de PHPBoost!

Voila on aurait bien besoin de quelques membres pour m'aider dans la documentation! C'est bien beau vous allez me dire, mais pourquoi rédiger des documentations? Qu'est ce que cela apporte? Quelles sont les conditions pour entrer dans l'équipe?

Pourquoi rédiger des documentations?

Tout d'abord, je tiens à préciser que tout projet a besoin d'une documentation la plus complète. Avez vous déjà acheté un logiciel, un appareil ménager,... Bizarre il y a toujours un petit livret inclus avec : la documentation!!! Et oui, ce 'machin' que bien souvent personne ne lit est là pour expliquer le fonctionnement du produit ainsi que ses subtilités (et cela sert je vous assure!!!) Et PHPBoost n'est pas une exception à la règle!

Qu'est ce que cela apporte?

Euh n'attendez pas la médaille de la plus haute distinction (faut pas rêver non plus )
Pour cette question, je vais vous expliquer mon expérience personnelle. M'occuper de la documentation de PHPBoost a été pour moi un excellent moyen de découvrir ce CMS (je vous assure il y a toujours des subtilités auxquelles on ne fait pas attention du premier coup d'oeil...). Faire la doc oblige de bien tester toutes les fonctions et la voila un rôle très important pour l'avancée de PHPBoost : la détection et l'avertissement des bugs. Enfin quand on connais bien le fonctionnement de PHPBoost, on est plus apte à répondre aux questions des utilisateurs sur le forum.
==> conclusion vous avez une double satisfaction : rendre le cms plus stable, plus simpliste à l'utilisation et créer une source de données sur son fonctionnement afin d'aider les utilisateurs.

Quelles sont les conditions pour entrer dans l'équipe?

Celui qui grince des dents en lisant cette petite phrase aura compris la règle d'or :
Citation:

Voila vous avez deviné il faut savoir bien écrire le français et s'exprimer le mieux possible afin que la documentation soit la plus claire et lisible possible!!!
L'idéal est de maitriser un peu le fonctionnement du CMS, mais bon cela vient avec le temps. Les balises du bbcode s'apprennent très vite donc ce ne sera pas un soucis.
Pour créer des copies d'écran, si vous ne savez pas faire je vous montrerai.
Enfin on ne vous demandera pas de rédiger un article par jour mais un minimum de présence sur le site de phpboost serait le bienvenue (du genre on ne vient pas pendant un mois et après on ne vous revoit plus). Rentrer dans une équipe impose un minimum d'investissement.

Le projet futur de la documentation

• Reprendre tous les articles actuels de la documentation existante pour l'améliorer.
• remplir la FAQ qui verra bientôt le jour
  

Comment bien rédiger un article?

Rédaction

Il n'a pas de technique miracle, mais pour bien uniformiser la doc je propose :

• utiliser le système de table des matières pour structurer l'article, en plus cela fait un lien en haut de l'article donc c'est bien (ainsi éviter le système titre/sous titres qui est plus adapté au reste du site qui ne contient pas ce système de table des matières
• bien détailler toutes les options du cms, ne pas hésiter à tester à fond toutes les fonctionnalités, c'est ainsi que l'on peut découvrir des bugs et ainsi les corriger pour rendre le cms plus stable) et à bien les détailler sur la doc
• écrire en français, clairement en soignant au maximum son orthographe, donc bien sur relire ses articles, on peut toujours laisser des coquilles donc si un lecteur en voie une il édite pour corriger.
• Mettre le plus possible de liens vers les autres articles du wiki en utilisant la balise [ link] [ /link]
  

Copies écran

L'idéal est de faire des copies d'écran, comme cela on voit directement de quoi on parle. Voila comment bien faire :

• utiliser le thème main
• éviter de mettre des zone vides
• faire des images en 640 de largeur ainsi cela tient sur les config 1024 mini)
  m'envoyer les copies d'écran pour que je les mettes sur le serveur. Y'a tout un répertoire du serveur consacré a la doc
  

Un petit travail pour rentrer dans l'équipe?

Puisque pour entrer dans les autres équipes de PHPBoost il y a un petit test, ce groupe ne fera pas d'exception. Je ne vous demanderai pas un article de 150 pages, juste un petit articles avec des copies d'écran et bien expliqué, sans fautes.

Le mieux est de me contacter pour voir un peu ce que vous pouvez faire.

Merci et bon courage à tous!