Définition du format des LIPE-RFC |
|
Définition du format des LIPE-RFC LIPE-RFC-N° : 0-0 Status : Définitive Date : 27-05-1999 Auteurs : Bernard FRIT Reference : Sujet : Proposition de définition d'un format de RFC applicable au projet LIPE. Proposition d'un mode de fonctionnement coopératif. Mots Clés : RFC, LIPE, LIPE-RFC, spécifications, format, coopération, Destinataires : Tous Remerciements : Jerome Vouillon Alain Couchot Laurent Ostiz Contenu : Afin de faciliter l'adoption des spécifications du projet LIPE (Projet LInux Pour l'Entreprise) l'utilisation de RFC (Request For Comments) semble pouvoir permettre d'avancer rapidemment par l'adoption successive de textes de référence. Elaboration des LIPE-RFC ------------------------ Chaque LIPE-RFC sera élaboré sur la liste spécialisée qui lui correspond. Par exemple ce LIPE-RFC-000 concernant l'ensemble de la communauté LIPE est présenté sur la liste générale LIPE. Par contre un LIPE-RFC concernant la comptabilité sera élaboré sur la Liste lipe_compta. L'élaboration d'un LIPE-RFC peut nécessiter plusieurs échanges de mails avant de parvenir à la rédaction d'un document structuré selon les règles défines ici. Format du LIPE-RFC ------------------ Chacun peut proposer un LIPE-RFC à condition de respecter les formes suivantes : - la numérotation doit être incrémentale. - le document doit contenir et renseigner les rubriques suivantes : # LIPE-RFC-N° : numéro de LIPE-RFC # Status : provisoire ou définitif une fois adopté après discussion et modification. Si le RFC est provisoire la rubrique status doit contenir le numéro de révision a, b, c etc... # Date : date au format jj-MM-AAAA # Auteur : Prénom, Nom et Email du ou des auteurs. # Reference : Rubrique facultative, indique une liste de LIPE-RFC de référence ex: LIPE-RFC-223, LIPE-RFC-655957 # Sujet : Court résumé du contenu. # Mots Clés : Mots clés faisant référence au contenu. # Destinataires : indique une classe de destinataires ex : tous, coordinateurs, comptabilité, etc.. # Remerciements : Liste des contributeurs Prénom Nom Email ex Jerome Vouillon # Contenu : contenu. Discussion des LIPE-RFC ------------------------ Après élaboration et publication sur sa liste d'origine, chaque RFC peut être discuté jusqu'à épuisement du sujet ce qui signale l'adoption de la dernière révision du RFC qui prend le numéro d'origine moins le numéro de révision. Ex : Ce LIPE-RFC-0000-a va pouvoir être discuté et modifié en LIPE-RFC-0-b, LIPE-RFC-0-c, etc.. et sera adopté en LIPE-RFC-0 Adoption des LIPE-RFC --------------------- Après épuisement du sujet sur sa liste d'origine le RFC sera publié sur la liste lipe_coord afin que chaque coordinateur puisse juger si le RFC proposé nécessite une discussion particulière sur une autre liste de LIPE. Auquel cas l'adoption définitive du RFC sera mise en réserve jusqu'à épuisement de la discussion sur cette autre liste. Dès lors que les réserves seront levées sur un RFC, il sera considéré comme adopté et sera publié sur sa liste d'origine ainsi que sur la liste lipe générale. Utilisation des LIPE-RFC ------------------------ Tous les LIPE-RFC seront stockés dans un répertoire ftp ou/et un site web accessible à tous les participants au projet LIPE. Les spécifications décrites dans les LIPE-RFC auront "force de loi" pour l'ensemble du projet LIPE. Un LIPE-RFC régulièrement adopté ne pourra plus être modifié. Seules les spécifications décrites dans un LIPE-RFC pourront être modifiées ou mises à jour dans un autre LIPE-RFC. Au fil du temps, certains LIPE-RFC pourront devenir obsolete, il sera maintenu une liste des RFC obsolete. Conseils de Rédaction --------------------- Il est recommandé de préparer la rédaction d'un RFC par des échanges d'idées ou de propositions informelles. Lorsqu'un début de position commune semble se manifester alors, il est temps de passer à la rédaction d'une proposition de RFC. Chacun peut prendre l'initiative de cette rédaction en faisant la synthèse des positions exprimées par chacun. Il faut essayer d'intégrer tous les commentaires faits. Il ne faut pas indiquer dans le RFC seulement les solutions choisies, mais pourquoi elles ont été choisies, et pourquoi les autres propositions ont été rejetées. Remarque -------- Afin de se prémunir de toute confusion éventuelle toute référence à un RFC de LIPE sera indiquée sous la forme LIPE-RFC-xxxx.