[Wayfinder] Question stupide mais..

Tu peux te créer un compte sur le wiki et commencer la doc de wayfinder Grin

Franchement ?

oui.
Mais pour ca va falloir que j’avance un tout pt peu plus quand même...

Quote from: elz64 at Sep 21, 2006, 07:33 AM

Ce serait bien pour gagner du tps que ces quelques principes de description de Pourquoi, Comment, d’un snippet, fassent partie intégrante de leur doc, au lieu d’attaquer bille en tête avec le détails des paramètres,des TV, etc.(ca c’est du domaine de l’annexe d’une doc). Le même pb existe dans d’autres cms ’pro’ où 9 composants sur 10 ont une doc rédigée par un ’geek’ qui n’est pas un rédacteur technique et pour qui la moitié de ce qu’il y a à dire est une d’une telle évidence crasse que ce na vient même pas à l’idée d’en parler..

Pour avoir gérer la version française de la doc de Textpattern pendant un moment, je peux dire que la rédaction technique, c’est un vrai problème. Un bon rédacteur technique est quelqu’un qui non seulement connaît les deux langues (et est capable traduire de manière non litérale), mais aussi qui connaît et maîtrise le sujet sur lequel il écrit.

Je pense que rien n’est évident, il faut partir de ce principe lorsqu’on rédige de la doc.

Ceci dit, au jour d’aujourd’hui je répète MODx ne s’adresse PAS à des débutants (c’est aussi une question de ressources). La doc des snippets, la plupart du temps, permet sans problème a un pro ou un amateur éclairé de s’y retrouver assez facilement.

Pour en revenir encore et encore à la comparaison avec des CMS comme Typo3 ou Joomla : il faut comparer ce qui est comparable entre 1 an et des brouette d’existence et 6/7 ans...

sur,

ceci dit, David, on est tous à un moment donné débutant en MODx ou en n’importe quoi.
Je suis désolé si je ne capte pas les doc que j’ai sous le nez du fait d’un vocabulaire et de concepts nouveau. (je ne parle pas de css ou xhtml que je maitrise pluto bien, mais c’est vrai je ne suis pas codeur php).
(si tu veux je te file un readme d’install d’un Netware 5.12 en NDS e-Directory, c’est aussi pour des pro, mais ...)

Je ne doute absolument pas d’arriver à dompter Modx, mais je reconnais n’avoir aucune patience pour farfouiller pendant des jours pour comprendre UN truc et devoir réinventer l’eau tiède. (probablement plus formateur certes, mais peu efficient).

Je suis contre toute forme d’élitisme en général:
Quand 1 heure pourrait suffire pour capter un concept, ca me gonfle d’y passer 1 semaine. Je me fais assez C.. comme ca par ailleurs à essayer de gérer ma boite. S’inspirer de bonnes pratiques à tous niveau de process est AUSSI un gage de qualité.

Mais bon, pas de polémique.
Ne nous fachons pas. J’adore ce forum, parce que au moins on échange et le produit en vaut le coût

Courage elz

Je crois qu’on a tous été rebuté au début lorsqu’il a fallu mettre les mains dans le camboui pour comprendre les chunks (encore que si on comprend que les chunks ont le même fonctionnement que les include en php, ça passe), les snippets, les tv, etc...

Mais finalement, quand on a compris la mécanique, on s’y fait.

En tout cas, la communauté présente sur ce forum est très active et j’ai toujours trouvé écho à mes questions de débutante :p

Que dire d’autre..

Merci

J’ai répondu initialement sur ce fil de discussion, mais j’ai préféré deplacer ma réponse dans la FAQ :
http://modxcms.com/forums/index.php/topic,7332.0.html

J’ai quelques notions de benchmarking et des process... c’était mon job en tant que consultant en organisation, spécialiste du management des processus et de la qualité totale. Je suis aussi contre l’élitisme, mais en tant que manager je suis aussi pour l’allocation des ressources la plus efficiente et aujourd’hui, ce n’est pas en documentant une version qui va disparaître dans 6 mois maxi (la 1.0 est un code totalement nouveau) qu’on ferait le bon choix...

J’arrive trop tot vu mon niveau d’exigence et " d’urgence" zut alors, mais je comprends ton argumentation vu sous l’angle des gestion de priorités.

Que la 1.0 remettra-t-elle en cause ?

Si ds qq mois je suis tjs là j’espère pouvoir contribuer à ce qui me tient à coeur aujourd’hui

Il est temps de clore ce fil .. j’ai plein d’autre idées

Arriver trop tôt, non pas forcémment simplement il faudra du temps pour pouvoir répondre à ton besoin de documentation...

Mon but n’est pas de te décourager (ni personne d’autre d’ailleurs...), simplement d’être clair sur les priorité l’équipe autour de MODx. Je pense malgré le fait que la doc soit limitée qu’il est tout à fait possible de se former sur MODx, notamment grâce au forum qui est l’un des plus actifs et sympathique que j’ai connu...

La 1.0 est en développement depuis près d’un an, Jason a apparemment documenté au fil du temps l’API donc on va avoir une bonne base. Evidemment, nous comptons aussi sur l’élargissement de la base des utilisateurs "experts" succeptible de nous aider à rédiger celle-ci...