Re: [Squeak-fr] standard de présentation dans ofset ?

[Serge Stinckwich]

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)]   \  /
                                                             ##