Bonjour,

Je vous propose un bilan de la journée Pure Data du 15 mai 2010.
Après validation et amélioration du document, nous pourrions l'envoyer à la communauté Pure Data francophone.

La Journée OFF Pd s'est déroulée le 15 mai 2010 à Mains d'Oeuvres de 14h à 21h30.
Elle était scindée en deux parties :
	1. Présentations des travaux et des expériences artistiques des élèves des cours du soir Pd du second semestre 2010.
	2. Discussion autour de la documentation de Pd, notamment francophone, avec des élèves, les organisateurs et deux membres de la commaunuté : Okno à Bruxelles et Mathieu Bouchard à Montréal.

--------------------------
- 1. Bilan présentations - 
--------------------------
Bilan interne (et très succint, Agnès fera mieux) pour les formateurs du CRAS. Pas nécessaire de l'envoyer à la communauté FR.
Présentations de 14h-17h à la salle Star Trek. 
Au niveau de l'organisation, c'était très (trop ?) souple. Du coup, cela a duré plus longtemps, une personne Yro Yto n'a pas pu passer.
Je regrette de ne pas avoir su qu'Yro Yto avait une obligation, il aurait pu passer au début.

Les présentations étaient variées, riches, bien construites (un réel effort de présentation) et intéressantes avec un réél point de vue artistique. L'échange a eu lieu. C'est franchement un succès.
C'est à refaire.

Après les présentations, quelques idées pour la suite ont été émises :
	- exercice pour élèves : expliquer, commenter son patch + collaborer à la doc.
	- séances pd (comme les club de montréal ?) : échanges, sessions de travail en commun 1 fois / mois. Jack a demandé à la maison des métallos. Idée de faire tourner ces séances dans plusieurs lieux (Mains d'Oeuvres, La Générale, ...).

--------------------------------
- 2. Documentation de Pue Data -  
--------------------------------

- 2.1. Constats -
-----------------
Constat de la faiblesse de la doc Pd : doc interne du logiciel trop confuse, sur le web aussi, initiative personnelle, etc.
Il y a un besoin d'une documentation en papier. En anglais, on trouve maintenant un Flossmanual très bien fait (http://en.flossmanuals.net/puredata).
Il manque une ressource francophone papier, imprimable et collaborative pour les écoles, les pédagogues, disponible sur le web en html/pdf. 
L'anglais reste un obstacle majeur pour l'apprentissage de Pd. On a parlé des pays africains francophones qui déjà parlent le FR + leurs langues, mais qui ont moins d'aisance en anglais. La francophonie c'est 70 pays, l'anglais n'y est pas maîtrisé tout simplement.

Autres besoins émis lors de la discussion : 
	- Glossaire des termes techniques anglais > français. Notion à prendre en compte dans l'apprentissage de Pd. Les domaines abordés sont variés et pointus. Les connaissances à avoir ne sont pas internes à Pd.
	- Rassembler les ressources pour l'initiation / patchs. 
		Je pensais à qq chose comme ça pour la communauté FR : en haut de cette page http://impala.utopia.free.fr/pd/ ou bien les ressources de codelab http://codelab.fr/73 et http://impala.utopia.free.fr/pd/patchs/selection/ pour rassembler qq patchs, chose que tout le monde fait chez soi j'imagine.
		Sur le site de la communauté : http://puredata.info/docs
	- Il manque peut-être un espace pour la communauté francophone sur le site puredata.info comme celle-ci : http://wiki.puredata.info/fr/Pdpedia:Accueil combiné avec le point précédent. Est-ce que toute la communauté francophone est représentée ?
Recenser les listes de diffusion : Montréal, Bruxelles, Orléans, Nantes, Dakar, codelab/puredata, pdpedia, ...

Pour la documentation, rassembler nos forces pour éviter les gâchis et les doublons inutiles, et surtout, combler le manque de concertation, en mêlant experts, développeurs, utilisateurs et débutants.
C'est sur ce dernier point, essentiel, que nous avons essayé de répondre pendant cette journée. C'est encore un point à développer, à travailler dans la durée, il me semble, Agnès ne me contredira pas, n'est-ce pas ?

- 2.2. Décisions -
------------------
A. ABANDONNER PDPEDIA.
B. DISTINGUER LES NIVEAUX D'UNE DOCUMENTATION.
C. TRADUIRE UN MANUEL PURE DATA EN FRANCAIS BASE SUR CELUI DE FLOSSMANUAL.
D. STRUCTURER LES FICHIERS D'AIDE PURE DATA POUR ELABORER LE LEXIQUE D'OBJETS.

- 2.2.A. Abandonner Pdpédia -
-----------------------------
Le constat est évocateur. Le projet a été discuté en septembre 2006 sur la liste pdpedia du craslab. Il a été mis en place après la convention internationale de pure data de 2007 à Montréal.
http://puredata.info/dev/pddp/pdpedia
http://wiki.puredata.info/

Depuis, le lexique français doit avoir une vingtaine de pages d'écrites sur 2500 objets + les bilbiothèques et autres pages. C'est donc un échec, qui fait (malheureusement) écho aux premières critiques énoncées sur la liste pdpedia.
Le travail est fastidieux, énorme, trop lourd pour la poignée de collaborateurs volontaires, et peut-être aussi inutile.
En effet, il y a doublon entre le lexique sur Internet et les fichiers d'aide Pd interne au logiciel (*-help.pd).
Nous verrons des propositions dans le point 2.2.D, car l'idée d'un lexique collaboratif reste pertinente et nécessaire.

- 2.2.B. Distinguer les niveaux d'une documentation -
-----------------------------------------------------
L'échec de Pdpédia impose de bien séparer les termes et les niveaux d'une documentation par rapport aux publics :
	- Un manuel sous forme WEB et papier (.pdf), comme point d'entrée non exhaustifs pour l'initiation, avec une progressivité dans la complexité. En anglais, il existe deux manuels aujourd'hui : le manuel officiel de Miller Puckette inclus dans le programme http://www.crca.ucsd.edu/~msp/Pd_documentation/ et le manuel de Flossmanual. L'idée la plus utile serait donc de traduire un manuel en français (voir 2.2.C)
	- Des tutoriels, idem, mais sous forme de patchs + éventuellement papier ou/et Web. L'idée serait, dans un second temps, de rassembler les tutoriels français, celui de Raphael Isdant, de Labomédia, le mien (et d'autres...), d'en faire un, de référence et à plusieurs. Ou bien en faire sur des sujets plus pointus comme ceux que l'on a fait pour les cours du soir. Peut-être que ce n'est pas prioritaire.
	- Un lexique d'objets pour avoir une vue d'ensemble de tous les objets, pour faciliter la recherche par mot-clé (besoin qui semble aujourd'hui très demandé) et faire des liens avec d'autres objets (comme actuellement dans certaines aides un sous patch [pd RELATED_OBJECTS]

Y en aurai-t-il d'autres ?

Cette séparation des termes est clairement identifiée dans la page de Processing, qui par sa clareté est un bon exemple. Ils distinguent Reference, avec le lexique classé par fonctionnalité, et Learning pour les tutoriels. En ce sens le site officiel de Pd est très confus.

Il faut essayer aussi de savoir ce qu'il faut ou non traduire. L'idée qui semble la plus partagée est celle qui consiste à traduire le maximum pour les débutants et ensuite d'essayer de traduire les termes techniques bloquants pour la compréhension d'un patch pour les utilisateurs avancés. (ou alors ceux-ci cherchent aussi tout seul sur Internet ?)

- 2.2.C. Traduire un manuel Pd en Français basé sur celui de Flossmanual -
--------------------------------------------------------------------------
	- Rassembler et discuter avec la communauté FR sur ce sujet.
	- Communauté de bruxelles Okno ont eu une subvention pour commencer ce travail
	- Se coordonner, prendre contact avec flossmanual, leur système de rédaction et de gestion de version
	- Agnès pense à la francophonie pour financer des voyages, réunions, etc.
	- Ouverture d'un canal IRC #pdflossfr ?
	- A montréal qq'un est déjà sur l'idée de ce manuel
	- A Paris, contacter Raphael Isdant
	- Se lier à des universités, écoles de Beaux-arts ?

- 2.2.D. Structurer les fichiers d'aide Pd pour élaborer le lexique d'objets -
------------------------------------------------------------------------------
	- Postulat 1 : les fichiers pure data (*-help.pd) sont la source de la documentation. Donc pas de doublon. Donc il faut se coordiner avec la communauté internationale en premier lieu.	
	
	- Postulat 2 : l'actualisation de l'aide est séparée de l'actualisation des objets.

	- Etat de l'art : 
		.PDDP (Pure Data Documentation Project) : voir doc/5.references/all_about_*  et http://puredata.info/dev/pddp
		.GFPD (Gridflow Documentation Project), basé sur des abstractions
		.Pure Data Base Project : obsolète
		.le fichier OBJECTS.txt dans Pd
		.clic droit + help dans page blanche.
		.Y en a t'il d'autres ?
		.Y a-t-il une liste de diffusion dédiée à la documentation ?

	- Nouveautés qui peuvent être importantes dans les versions futures de Pd, notamment la localisation :
		http://puredata.info/dev/PdGuiRewriteScreenshots

	- Intérêts de structurer les fichiers d'aide :
		.présentation homogène
		.centralisation de la traduction dans un fichier help-fr.txt, help-en.txt, help-de.txt, etc.
		.recherche par mots clés
		.liens vers autres objets

	- Idées techniques émises : 
		0. En imaginant que les patchs d'aide soient à jour, on pourrait faire un script multiplateforme pour les combiner en un seul fichier dans un format imprimable :
		 	*-help.pd > *.ps > all.ps
			*-help.pd > *.jpg > all.jpg
			*-help.pd > *.pdf > all.pdf

		1. Extraire les #X text (les commentaires en anglais) => les afficher dans une petite application ou serveur pour les éditer (php ou python ou ...) et les réenregistrer en français dans le fichier -help.pd

		2. GOP abstraction ou objets. Postulat : se mettre d'accord sur une organisation en X et Y de la présentation d'un patch : titre en haut, objets connectés + commentaires en anglais (cette partie serait intouchable), et ensuite section de traduction avec repéres. La solution technique la plus automatique serait de détecter l'extension du fichier -help.pd, si c'est help.pd, alors appel de la méthode qui va construire l'help de cet objet. On peut imaginer une abstraction qui va scanner le texte de la documentation de la bibliothèque de l'objet (gem-help-fr.txt) avec un [textfile] et qui va identifier les balises <object> pour trouver celle qui correspond à l'objet appelant, ensuite construction de l'aide entre les deux balises <object><decription> blabla a </description> < author> </author> </object>. Il faut aussi déterminer l'ordonnée la plus basse du dernier objet de l'aide pour pouvoir intégrer les canvas et commentaires de l'aide en dessous des objets connectés.
Pour ces balises on peut utiliser ce qui s'est fait pour pdpédia. Grâce à ce système on peut imaginer extraire tous les objets pour les afficher en html, etc, les éditer dans le fichier gem-help.txt. Jack va travailler un peu sur cette solution.
Je pense que pour l'édition de ces fichiers d'aide de façon externe à pd, il faudrait avoir une image du patch pour pouvoir traduire un ensemble d'objet assez facilement.
	
	Pour les sous patchs, comment faire ?
	Il faudrait intégrer deux niveaux de description. Une description simplifiée directement visible qui servirait aussi à la recherche de mots clés et ensuite un lien vers des informations plus détaillées, plus techniques, sous la forme d'un sous patch ?

	- Autres idées : 
		- Thomas de Montréal : deux fichiers -help.pd, -example.pd. => deux niveaux de documentation, le lexique avec les -help.pd et la façon d'utiliser ces objets avec -example.pd. Ces deux niveaux me semble très utiles.
		- Se mettre d'accord sur le choix des mots clés.
		- Refléchir sur le principe d'un moteur de recherche de mots clés dans les balises <description>