Objectifs
Les objectifs de ce site sont de permettre de contribuer au développement du driver eagle-usb
- Constituer de la documentation à inclure ensuite dans le packaging (principalement docs utilisateurs)
- Avoir une trace des choix de développement effectués (principalement docs développements, anomalies)
-
Faire simple, ordonné et réutilisable
- Une évolution ultérieure pourra être de constituer des FAQ issues du Forum ou une trace des analyses de problèmes rencontrés (qu'il y ait une solution ou pas encore)
Licence
Le travail effectué sur ce wikini ayant vocation à faire partie du driver eagle-usb version GPL, ce wikini doit adopter une licence libre qui permette sa diffusion / réutilisation le plus libre possible.
Les licences suivantes sont envisagées :
Ce document est licencié selon les termes de la GNU Free Document License Copyright © 2003 ?????
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation ; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
D'autres licences sont possibles (revérifier sur wikini...) et peut-être plus adaptées à la création collaborative de documents de conception logiciel ??
Pour le driver eagle-usb, la licence GPL s'applique (retrouver le texte)
Besoins
- Organisation du site claire :
PlanDuSite (quoi est où, accès rapide), tant pour celui qui va consulter que celui qui va alimenter
. les documents "utilisateurs" peuvent faire des liens vers documents de développement
. les documents de développement peuvent être déclinés par problématique traitée
. il serait bon d'avoir une tête de chapitre permettant de regrouper / organiser à chaque fois
- Gestion "Projet" : définir ordre d'alimentation des documents, quoi va où, décliner documents selon les besoins et le niveau de détail
. mieux vaut commencer avec peu de documents, peut-être "fourre-tout" au début (avec des titres tout de même) mais qui pourront être coupés ensuite en plusieurs documents
.
DeveloppementEagleUSB : les "normes", repris de wikini.net (non dogmatique, à utiliser de manière pragmatique)
Reste à faire
- peut-être prendre en compte version CVS de Wikini ( fonctionnalités supplémentaires ) => demander date où elle est stabilisée (~ok version du 22/10/2003 retenue)
- voir hébergement chez tuxfamily : pourrait être à côté du site eagle-usb (OK fait le 25/10/2003)
- pour gestion de l'internationalisation : il faudrait définir ce qui fait référence (doc en anglais ?) et avoir une navigation transversale (passer rapidement de l'anglais au français à l'espagnol)
- demander une évolution sur Wikini.net : gérer un profil utilisateur de langue (au moins) et créer les documents en conséquence avec une extension par exemple DocumentSpecification_FR DocumentSpecification_EN DocumentSpecification_ES respectivement pour Français, Anglais, Espagnol avec affichage du doc' dans la langue choisie par l'utilisateur et - si le doc n'existe pas - dans la langue où il existe (+ navigation proposée automatiquement pour passer de l'un à l'autre)
