Après quelques semaines de réflexion sur le problème, il me semble évident que le manque de structuration et de visibilité de la documentation de REBOL reste LE gros point faible du language. Il me parait également clair que nous ne devons compter sur REBOL Technologies ni pour la production de documentation supplémentaire, ni pour la traduction de l’existant: Carl et son équipe préferrent se consacrer au développement du code…

Des besoins ont été exprimés, mais de manière décentralisée et sans approche systèmatique. Cela n’est évidement pas un reproche mais un simple constat…

Je propose donc le lancement d’un projet collaboratif visant à documenter REBOL.

Le REBOL Documentation Project aurait pour objectif de structurer l’accés à la documentation existante et développer de la documentation libre pour le language de programmation REBOL. Ce développement inclurait la création de “Howtos”, de dictionnaires, de manuels, d’articles techniques, de news, etc… Nous esperons établir une système de consultation simple à utiliser et facilitant les recherches.

Le REBOL Documentation Project sera basé sur le travail d’une équipe de volontaires et d’une organisation centralisée minimum. Tout le monde sera invité à participer à l’effort commun. Un media sera utilisé afin de centraliser les discussions possibles (ce forum par exemple). Les désaccords éventuels devront être débattus dans le groupe jusqu’à l’obtention d’un consensus.

Afin d’aborder le problème, je suggére d’employer un canevas d’analyse simple mais suffisant, qui reste compréhensible par tous, sans laisser pour cela certains points non-traités.

La méthode d’analyse proposée est:

1. Analyse du problème
   1. Evaluation de l’existant
   2. Expression des besoins
   3. Etude des moyens
2. Solutions possibles
3. Solution retenue
4. Coûts
   1. Financiers
   2. Resources
   3. Risques
5. Revenus
   1. Financiers
   2. Return on Investment
   3. Autres
6. Planning

Une personne devant centraliser et synthétiser les renseignements, je me propose, dans la mesure de mes moyens, afin d’assurer la coordination des efforts.

J’ai réalisé une analyse préalable qui sera développée dans ce thread au fur et à mesure des nécessités (afin de n’influencer personne).

Je pense opportun que, préalablement au lancement officiel de ce projet, un consensus soit trouvé au sein de la communauté sur les points suivants:

1. La nécessité de ce projet
2. Il s’agit d’un projet collaboratif, donc l’effort doit être collectif.
3. Les efforts doivent se concentrer sur le contenu, et non pas la forme. Ce qui implique que si, du moins dans un premier temps, il apparait que l’utilisation de SPIP ou de MediaWiki est opportune afin de mieux structurer la documentation, nous ne devons pas tergiverser sur le fait que ces produits “ne sont pas REBOL”…
4. Ce projet est un effort à long terme, et les premiers effets ne se feront peut-être sentir que d’ici un an ou plus…

–RebolTof