DocBase et Rebol Documentation Project
Goldevil14-Jan-2008/15:18:42+1:00
Bonjour à tous,

La sortie de R3 relance un souffle nouveau sur le monde Rebol et pas mal de choses bougent.

Je suppose (j'espère) que vous connaissez tous le site Rebol Documentation Project (http://rebdocproj.org) qui contient beaucoup de documentation concernant Rebol.

Maintenant, il existe DocBase (http://www.rebol.net/wiki) qui a exactement le même objectif.

Giuseppe Chillemi est responsable de l'intégration de documentations R2 sur DocBase et aimerait traduire de la doc provenant de rebdocproj pour l'intégrer à DocBase. Il a posté un message sur la mailing list à ce sujet.

Sachant que RebolTof, le papa de rebdocproj n'a plus le temps de s'en occuper je me demande carrément si le transfert complet du contenu de rebdocproj vers DocBase ne serait pas une bonne idée. En fin de compte le but est identique et cela donnerait un nouveau souffle au projet de Christophe/Reboltof.

Evidemment je me suis fait quelques réflexions.

Il faut que les auteurs soient d'accord.

Reboltof a mis sur pied un processus de publication avec une équipe de relecteur. Cela assure une bonne qualité des articles. DocBase est un Wiki. Le fonctionnement est différent.

Est-ce que DocBase sera multilingue ?
Si oui, s'agira-t-il de traductions d'articles en anglais (comme le manuel rebol/core) ou est-il possible d'y publier des articles uniquement en français ?


Qu'en pensez-vous ? Je pose la question en particulier au gens qui ont beaucoup travailler pour rebdocproj comme Philippe et Reboltof par exemple.


Sinon, si vous désirez aider Guiseppe (même un tout petit peu), n'hésitez pas à le contacter via la mailing list. Si vous désirez son adresse email, vous pouvez me contacter via le formulaire de rebol-france.org.
Didec15-Jan-2008/10:10:49+1:00
Je n'ai pas la réponse à toutes ces questions.

Néanmoins, 2 choses :

1) DocBase est là pour contenir la doc de R3. Je ne sais pas si il y a une volonté d'y intégrer celle de R2 !

2) MedaWiki a été utilisé pour gagner du temps, mais au final, Carl souhaite utiliser une solution en Rebol qui est a créer. Entre autre, pour gérer l'internationalisation de la doc !
Goldevil15-Jan-2008/16:08:41+1:00
A moi aussi il m'avait semblé que DocBase était orienté R3 et j'ai été étonné de l'initiative de Guiseppe. Mais d'un autre côté je pense qu'il y a pas mal de choses à récupérer dans la doc existante :

- Parfois des articles et des morceaux de codes restent parfaitement pertinents en R3 éventuellement avec des petites modifications ou optimisations.

- Des partie de documentation officielle peut servir de base pour la doc de R3. Je pense surtout au manuel de rebol/core. On peut faire du copier-coller de chapitres complets même si finalement le doc se structure différemment.

- Il serait intéressant d'avoir des articles du type "Ce qui change avec R3", "Comment changer son code pour R3",... Une bonne base est de reprendre les sujets traitants de R2 et d'analyser leur adaptation pour R3.

En résumé, pour avoir un documentation R3 la plus complète possible pourquoi ne pas récupérer ce qui est récupérable dans la documentation et les articles concernant R3.

J'aime assez bien cette idée de Media-Wiki comme solution rapide et efficace. Mais il est vrai que j'espère voir de plus en plus d'outils écris en Rebol.
Philippe16-Jan-2008/9:31:26+1:00
Salut !

En fait, la doc sur le RDP est sous SPIP, outil très pratique pour faire de l'édition. J'ai ramené sans pb le contenu de SPIP. Néanmoins, SPIP n'est pas super pratique pour exporter des articles vers d'autres systèmes, il faut faire pas mal d'opérations, c'est du au fait que SPIP possède un langage interne et au système de références des docs. J'ai un début de solution depuis les exports xml, mais pas mal de ménage à faire.
En fait, il faut conserver l'existant (je rappelle que j'ai aussi le "vieux forum" sous forme de fichiers texte), et voir le delta avec R3, comme proposé.
Idealement, si la DocBase proposait une solution d'import sous format structuré sur une section francophone, ce serait peut-être jouable ?

Pour R3 : comme j'ai fait la traduction du User Guide de Core, je pensais repartir de là pour balayer chapitre par chapitre le R3, et peut-être aussi mon Introduction à View.
Et Il y a aussi la traduction du Dictionnaire, faite à plusieurs mains..

Bon, maintenant, reste à trouver le temps pour cela.

Didec, est-ce que Anamonitor sera porté sur le R3 ?

===Philippe
Didec21-Jan-2008/13:09:31+1:00
Aucune idée. C'est Romano qui l'a créé et je n'ai pas de nouvelles de lui depuis un bon moment.

Login required to Post.


Powered by RebelBB and REBOL 2.7.8.4.2