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
