En ce qui concerne la documentation, sur quoi faut-il porter nos efforts de traduction en priorité ?

Events happening in the community are now at Drupal community events on www.drupal.org.
ineation's picture
La documentation de base
23% (5 votes)
La documentation des modules phares (CCK, Views...)
23% (5 votes)
Les formations et exercices
27% (6 votes)
Les études de cas
14% (3 votes)
Autres (à préciser)...
0% (0 votes)
Merci, mais la doc anglaise me convient parfaitement
14% (3 votes)
Total votes: 22

Comments

Quelle documentation pour quel public?

damien tournoud's picture

Dans l'ensemble, je dirais que la réponse dépend du public que l'on considère. La documentation anglaise convient parfaitement pour les utilisateurs avancés, elle est très complète et généralement pertinente. Il reste donc peu de place pour de la document un peu avancée.

Par contre, il pourrait être pertinent de réduire la barrière à l'entrée de Drupal, et la fameuse "courbe d'apprentissage". Dans ce cadre, on pourrait se concentrer sur la document de base (installation de base, installation de la traduction) et sur des formations pratiques (conception d'un site en pas à pas, avec utilisation des modules incontournables types Views et CCK, bonnes pratiques etc.).

Il ne s'agit pas de traduire de la documentation (cela n'aurait peu d'intérêt), mais de concevoir du contenu original apte à attirer plus de monde vers l'outil.

Drupal-fr possède déjà une partie documentation [1], assez fouillée même si un peu ancienne. Ce serait l'occasion de la remettre à plat.

Damien Tournoud
http://drupalfr.org

[1] http://drupalfr.org/documentation

Damien Tournoud

@damz Je dois dire que je

ineation's picture

@damz
Je dois dire que je suis plutôt en ligne avec tes commentaires.
En ce qui me concerne la doc Anglaise me convient parfaitement. Ceci dit je pense que ce n'est pas le cas de tous (voir toutes les discussions sur les forums). Sans compter que c'est un facteur clé bien connu qui favorise le développement d'un produit ou une offre en France.

Je pense que c'est une très bonne idée de donner un contenu original à la doc Française. Cela lui donnera plus de valeur, et pourra ainsi aussi intéresser plus de personnes. Mais cela nécessite aussi plus de boulot...

Pourquoi ne pas donner forme à une série d'exercices pratiques (un exercice par module ou par thème). L'idée serait que chaque exercice puisse être traité de façon indépendante mais que la réalisation de tous les exercices puissent permettre la réalisation d'un site 100% fonctionnel.

On pourrait aussi imaginer que ce site soit une sorte de "maison témoin" qui permette de découvrir toutes les fonctionnalités de Drupal... Oulà faut que j'arrête, faisons simple pour commencer !

Par contre, en ce qui concerne la doc de drupal-fr, je la trouve aujourd'hui un peu disparate et trop pauvre. Je suis prêt à aider à la remettre à plat comme tu le proposes.

Alex
www.ineation.com

doc de base

martin gersbach's picture

[Moi aussi d'accord avec vos commentaires.]

Pour moi c'est la doc de base sans aucune doute.
Comme admin de Drupal Hispano (www.drupal.org.es) je peux vous assurer qu'est évidente que personne lit la doc basique (en anglais).
résultat : les forums sont ils débordée de questions basiques et repetitives.

Conclusion :
- Pas besoin de se concentrer dans la doc pour les avancées car la plus part comprend le français (ou PHP).
- Se concentrer en la doc basique va nous permettre 'ouvrir les portes' et diminuer les questions des doomies.
- Et trois : "je ne veut pas aider ma concurrence directe" = Drupal est aussi un outil de travail que nous aide a faire des bénéfices = Si tu veux un formation Drupal (pas de temps pour lire/étudier) = @700€ jour (le cas de Vincent, pour exemple).

(oui, c'est complètement con, mais aussi évidente dans les forums = pas besoin d'insister pour cette chemin car le résultat est là)

Martin

Martin Gersbach
Directeur Technique
www.troisfourmis.com

Ce n'est pas incompatible !

damien tournoud's picture

Martin, je ne comprends pas bien ta remarque sur les formations.

Je ne crois pas qu'il y ait une incompatibilité entre offrir de la documentation de qualité et développer l'offre de formation. Bien au contraire, si la documentation écrite est bien faite, cela peut donner envie d'en apprendre plus en formation. Dans ce domaine, l'apport principal du formateur est son expérience, et son vécu accumulé au fil de ses réalisations.

J'aimerais voir à la fois développée l'offre de documentation (sur drupalfr ou ailleurs), et l'offre de formation, par le biais des professionnels talentueux que nous avons en France et dans la francophonie.

Damien Tournoud
http://drupalfr.org

Damien Tournoud

Je me suis mal exprimé...

martin gersbach's picture

Damz,

Je me suis mal exprimé.

Je vais essayer de justifier ma réponse: "la documentation de base"
qui vient suite à la question: "En ce qui concerne la documentation, sur quoi faut-il porter nos efforts de traduction en priorité ?"

Cela fait déjà qq années que je participe à plusieurs forums et je n'ai jamais vu personne ayant les outils pour créer une documentation gratuite et supérieure au niveau basique. En général, cela se termine par la sortie d'un livre ou des formations payantes.
Un bon exemple: DrupalFR ou Drupal Hispano.

C'est pour cela que je pense qu'il vaut mieux se concentrer sur la base. La mise à disposition de documentation avancée ou les formations sont assurées par des personnes ou sociétés qui en font leur commerce (j'espère sincèrement que Vincent ou autres personnes puissent avancer sur ce terrain ).
Je ne vois pas l'intérêt de m'asseoir pour pondre une doc avancée, qui finalement ne m'apportera rien - je n'ai même pas le temps de mettre mon site web à jour! (opinion partagée par d'autres personnes tout à fait capables de fournir une documentation professionnelle).

Bref, je suis complètement d'accord avec ton post : http://groups.drupal.org/node/9819#comment-30845
principalement avec le troixieme paragraphe ou dit : "Il ne s'agit pas de traduire de la documentation (cela n'aurait peu d'intérêt), mais de concevoir du contenu original apte à attirer plus de monde vers l'outil."

Martin Gersbach
Directeur Technique
www.troisfourmis.com

Le coût actuel de la

vincentc's picture

Le coût actuel de la formation est 800 EUR HT pour 3 jours. :)

A ce prix là, c'est du dumping...

ineation's picture

;-)

Quel est ton plan à ce sujet ?

damien tournoud's picture

Quel est ton plan au sujet de tes formations Drupal, Vincent ?

Vas-tu continuer à en organiser, ou estimes-tu devoir t'arrêter ?

Dans tous les cas, ton aide et ton expérience serait précieuse pour développer l'offre de formation en France. Serais-tu prêt à tenir un session sur ce thème au prochain DrupalCampParis ?

Damien Tournoud
http://drupalfr.org

Damien Tournoud

pas cher de tout

martin gersbach's picture

he, Vincent...
dire 700EUR/jour c'etait que un exemple.

Martin Gersbach
Directeur Technique
www.troisfourmis.com

3 axes pour développer la formation

vincentc's picture

Je vois 3 axes pour développer la formation Drupal :

  • Plus de villes (pour l'instant, c'est seulement Paris, il faudrait développer les villes du sud).
  • Plus de spécialisation (pour l'instant, il n'y a qu'un module généraliste de 3 jours, il faudrait un module général, un module développement, un module design...).
  • Plus de dates (ça serait la conséquence des 2 premiers points).

Mais tout ça n'est pas très nouveau : j'ai essayé d'amorcer une évolution dans ce sens il y a quelques semaines (http://drupalfr.org/node/2970), mais sans retour concluant.

Selon moi, développer la formation = trouver des formateurs.
Organiser les dates, réaliser les supports de cours... tout ça, c'est le côté pratique et ça n'est pas ça qui bloque.
Pourquoi pas en discuter au DrupalCamp, mais pour moi, c'est la "main d'oeuvre" qui manque, pas les réflexions autour de l'idée.

Et pour répondre à ta question, damz, je n' "estime pas devoir m'arrêter" (devrais-je ? ;-) ).

Une petite synthèse

ineation's picture

Une petite synthèse libre des premières discussions sur le sujet de la documentation en Français.

  • La documentation de base : même si la doc. de Drupal.org en anglais est très bien faite, il semble indispensable d'avoir une doc claire et bien structurée afin de guider les nouveaux venus dans l'univers de Drupal. La documentation existante sur le site de Drupal est un très bon point de départ ; on peut envisager de la remanier, de la complèter et d'améliorer sa structure afin qu'elle soit encore plus efficace. Cela devrait aussi permettre de soulager (un peu ;-) ) le forum...
  • Exercice et formation : on pourrait compléter cette documentation de base par une série d'exercices qui permettrai de faire réaliser un vrai site en entier. On pourrait d'ailleurs insister pour que tous les débutants réalisent cet exercice avant de commencer leur propre projet. On s'assurera ainsi d'un meilleur niveau et donc de moins de questions basiques.
  • La documentation avancée : ce n'est pas notre priorité. Voir c'est ce qu'il ne faut pas faire car 1) C'est long à rédiger (bcp d'effort et d'énergie) 2) C'est difficile à maintenir et synchroniser avec d.o 3) C'est un service à forte valeur ajoutée, donc les gens sont prêt à payer pour l'obtenir (livre, formation, ou autre...) 4) les utilisateurs avancés sont (a priori) plus habitué à l'anglais
  • Les études de cas : personne ne l'a mentionné, pourtant je suis persuadé qu'une série d'étude de cas serait utile d'un point de vue markéting pour communiquer des "success stories" à vos clients et les persuader de la puissance de Drupal.

Voilà, j'espère n'avoir rien oublié de primordial. Maintenant si vous êtes OK , reste à savoir comment on met en œuvre cela.... Perso, je dois pouvoir aider au premier point et avec de l'aide au deuxième...

cool

martin gersbach's picture

cool, c'est ça...
comme je viens de répondre ici : http://groups.drupal.org/node/9819#comment-30991

ps : J'ai pensé faire dans mon site des petits morceaux de code/exemple mais que pour montrer comment j'ai solutionné un problème/demande et aussi, des petits docs/aides pour démarrer.
Et bien sûr que peut le mettre a disposition pour une doc générale et free.

bien, je vois qu'on est d'accord.
Est ce qu'on peut se faire un moment pour parler de ça a la DrupalCamp2 ?

on peut utiliser cette doc pour Drupal Hispano et partager les efforts
:D

a bientôt

Martin Gersbach
Directeur Technique
www.troisfourmis.com

Etudes de cas

vincentc's picture

Concernant les études de cas, je commence des interviews vidéo la semaine prochaine :
http://drupalfrance.com/blog/2008/03/retours-experience-projets-drupal-p...

France

Group organizers

Group categories

Chantiers

Group notifications

This group offers an RSS feed. Or subscribe to these personalized, sitewide feeds: