[Pdmtl] Pdp�dia party le 15 mai � Mains d'Oeuvres

[Mathieu Bouchard]

On Wed, 28 Apr 2010, Alexandre Quessy wrote:

> Ouais, en effet, l'id�e de g�n�rer automatiquement - et avec des erreurs 
> potentielles - des pages wiki, puis de demander aux usagers de les 
> remplir, ne me charme pas du tout.

Mais c'est pire que des erreurs potentielles, c'est plut�t des erreurs 
syst�matiques, jusqu'� maintenant. Il y a aucune mani�re que les 
commentaires des patchs d'aide puissent �tre copi�s automatiquement d'une 
mani�re qui prend tous les commentaires sans �gard aux d�pendances. Par 
exemple, beaucoup de commentaires n'existent que pour expliquer un exemple 
qui n'existe que dans le fichier d'aide et pas pdp�dia.

Pour les patchs d'aide de Pd, il n'y a que le GFDP qui permet l'extraction 
automatique fiable de ses commentaires pour en faire des pages pdp�dia. �a 
n'a pas �t� fait et c'est la premi�re fois que j'en parle, juste pour dire 
que les commentaires de patchs d'aide pd sont pas vraiment extrayables en 
moyenne, mais que �a se peut quand m�me, si c'est �crit en cons�quence.

Pour les erreurs syst�matiques, si c'�tait de l'ordre du corrigeable � la 
main en le temps que �a prend pour lire tout le texte, �a passerait, mais 
avec l'auto-importation actuelle, tout semble � refaire, et on dirait 
que la seule chose qui vaut la peine, c'est de recommencer l'auto-import 
de z�ro... une fois qu'on aura d�termin� pourquoi pdp�dia devrait exister.

Prendre docbook ou n'importe quoi d'autre d'�tranger � pd, �a va juste 
cr�er un autre probl�me similaire en r�glant rien : le format normal de la 
documentation pd est la patch d'aide, et on ne changera pas cet �tat des 
choses : il faut composer avec. Une erreur fondamentale du vieux GridFlow, 
c'�tait de faire un manuel de r�f�rence s�par�, en xml auto-transform� en 
html. 99% des utilisateurs s'attendent � avoir des *-help.pd, donc �a 
doublait la charge de travail, qui n'�tait pas faite, parce que �a valait 
toujours plus la peine de faire autre chose.

Puis il y a eu cette id�e de tout refaire avec le format PDDP, mais le 
format PDDP aussi, �a rajoute de la job par-dessus faire juste une patch 
d'aide normale, et �a rapporte pas grand-chose. On y apprend qu'aligner du 
texte, c'est long et ennuyeux, et qu'�crire des valeurs de grandeur de 
[cnv] dans le dialogue de propri�t�s, c'est long, ennuyeux, et d'autres 
�pith�tes que je ne peux pas dire ici.

Donc ce n'est qu'avec le projet GFDP que j'ai commenc� � avoir _envie_ 
d'�crire des patchs d'aide. �a devenait alors m�me plus int�ressant que 
l'id�e d'auto-g�n�rer des patchs d'aide � partir du xml !

Quand il s'agit de projets libres et non-subventionn�s (ou peu), il faut 
pas sous-estimer le c�t� fun, parce que si ne gagne pas un rond � faire 
quelque chose, il faut bien y gagner autre chose, et il faut ajuster les 
incitatifs en cons�quence.

> Sa place doit �tre dans le syst�me de r�vision des version (SVN), pas 
> sur le Web,

�a, c'est clair que c'est quelque chose � consid�rer : l'usage de syst�mes 
de r�visions multiples en m�me temps (d�j� SVN + GIT, maintenant M�diaWiki 
itou ?) rajoute des complexit�s qu'on aurait int�r�t � �viter.

> Pour les externals et abstractions Pure Data, la plupart sont regroup�es 
> dans le d�p�t SVN de puredata. Il serait donc facile de cr�er ou 
> d'am�liorer ce que fait la command "make html" dans le syst�me de build. 
> Thomas O.-F. a fait ce genre de "parsing" pour les PdMtlAbstractions. 
> (et probablement aussi pour la librarie mtl)

o� peut-on voir ce html ?

  _ _ __ ___ _____ ________ _____________ _____________________ ...
| Mathieu Bouchard, Montr�al, Qu�bec. t�l�phone: +1.514.383.3801