Author: tziade Date: Sun Mar 12 02:11:46 2006 New Revision: 2603 Modified: cookbook/trunk/recipe48.fr.tex Log: added a few rest good practices
Modified: cookbook/trunk/recipe48.fr.tex ============================================================================== --- cookbook/trunk/recipe48.fr.tex (original) +++ cookbook/trunk/recipe48.fr.tex Sun Mar 12 02:11:46 2006 @@ -144,7 +144,16 @@ \section*{Bonnes pratiques en vrac} -AFINIR +Voici une liste de bonne pratiques reST: +\begin{itemize} +\item V�rifier � ce que le fichier reST soit toujours syntaxiquement valide, +avec \code{rest2html} par exemple; +\item regrouper les liens en fin de fichier; +\item les fichiers reST constituent la documentation du package, ils doivent +�tre particuli�rement soign�s ; +\item Les en-t�tes de modules, de classes et autres fonctions peuvent aussi +adopter ce format. +\end{itemize} \end{solution} -- http://lists.nuxeo.com/mailman/listinfo/z3lab-checkins