Le 11 mai 06 à 23:44, Alain Plantec a écrit :
bonsoir,
Il y a t-il quelque-part une description de normes à respecter pour l'ecriture des doc squeak. par exemple :
- utilisation du gras-italique-souligné
- nommage des pages,
- comment référencer une classe ou un mot clé dont on sait qu'un
jour il y aura une page dédiée (euh... pas clair... par exemple : j'écris dans ma doc PluggableTextMorph, c'est le nom d'une classe et on peut espérer qu'un beau jour, il y aura une page de référence pour cette classe. J'utilise quoi ? [[PluggableTextMorph]] ou encore [[Classe-PluggableTextMorph|PluggableTextMorph]] ....)
- comment doit-on présenter le code d'une méthode :
PluggableTextMorph>>update: aSymbol ... ou update: aSymbol ... la première solution est plus explicite, la seconde permet le copier/coller.
- comment nomme t-on un message (#update: ou update)
Les règles ne sont pas explicités clairement pour l'instant même si j'en utilise certaines pour les articles que j'ai mis en ligne. Je propose de mettre les règles ici : http://community.ofset.org/wiki/ Conventions_typographiques_pour_les_pages_Squeak et d'en discuter sur la page discussion associé.
-- oooo Dr. Serge Stinckwich OOOOOOOO Université de Caen>CNRS UMR 6072>GREYC>MAD OOESUGOO http://purl.org/net/SergeStinckwich oooooo Smalltalkers do: [:it | All with: Class, (And love: it)] \ / ##