$Id: README,v 1.4 2005/09/11 20:02:33 ahmed Exp $


Le but -----------------------------------------------------------------

Adopter des methodes de developpeur 
pour finaliser les statuts de Neoskills 
assez rapidement.


Travailler sur les statuts ---------------------------------------------

Recuperer la derniere version.
 $ wget http://neoskills.com/all/html/BP/statuts/statuts.docbook

Garder une copie de l'original et travailler.
 $ cp statuts.docbook statuts-original.docbook
 $ vi statuts.docbook

Visualiser en HTML.
 $ xsltproc \
 > -o statuts.html
 > /usr/share/xml/docbook/stylesheet/nwalsh/xhtml/docbook.xsl \
 > statuts.docbook
 $ lynx statuts.html

Garder des lignes courtes.
Placer les sauts de ligne sur des articulations grammaticales.
L'XML doit garder une presentation standard. 
Il doit aussi mais surtout rester valide. 
 $ f=statuts.docbook ; xmllint --format $f > $f.tmp && mv $f.tmp $f
 $ xmllint --valid --noout statuts.docbook

Une fois satisfait des modifications, preparer un patch.
 $ diff -u statuts-original.docbook statuts.docbook  > reformuler_A_11_3.patch



Maintenir les statuts --------------------------------------------------

La source des statuts est une archive RCS.
 # man rcsinfo
 # ls -l
 total 228
 -rw-r--r--  1 ahmed ahmed 226525 Sep  7 20:37 statuts.docbook,v
 #

Appliquer un patch.
 # patch < reformuler_A_11_3.patch
 Get file statuts.docbook from RCS with lock? [y] y
 statuts.docbook,v  -->  statuts.docbook
 revision 1.10 (locked)
 done
 patching file statuts.docbook
 # 

Maintenir les statuts signifie etre responsable du contenu.
 $ emacs statuts.docbook
 $ f=statuts.docbook ; xmllint --format $f > $f.tmp && mv $f.tmp $f
 $ xmllint --valid --noout statuts.docbook

Enregistrer les modifications.
 # ci statuts.docbook
 statuts.docbook,v  <--  statuts.docbook
 new revision: 1.11; previous revision: 1.10
 enter log message, terminated with single '.' or end of file:
 >> Pas de nom de logiciel.
 >> Utiliser le present de l'indicatif.
 >> .
 done
 #

Rendre publique la derniere version.
 # co statuts.docbook
 statuts.docbook,v  -->  statuts.docbook
 revision 1.11
 done
 # scp statuts.docbook http://neoskills.com/all/html/BP/statuts/statuts.docbook



Meilleure facon --------------------------------------------------------

Avec le fichier intermediaire statuts.docbook, la derniere version publique, 
connaitre RCS n'est necessaire que de la part du mainteneur.
Si cette connaissance est generale, il est preferable de s'en passer 
et de ne travailler que sur l'archive RCS statuts.docbook,v directement.
L'historique est disponible. Les patchs sont plus precis. Le mainteneur a moins de travail.



Liens ------------------------------------------------------------------

- http://www.freenix.fr/unix/linux/HOWTO/mini/RCS.html
- http://www.docbook.org/tdg/en/html/docbook.html
- http://www.sagehill.net/docbookxsl/
- http://www.catb.org/~esr/doclifter/paradise.html