classement des docs par themes
tout est basé sur l'arborescence du filesystem
pas de fichiers annexes (descriptions) pour le moment
utilisation uniquement des noms des répertoires & fichiers
sous le répertoire "ressources"
les principales sections (entre 6 et 10)
puis des répertoires de rangement (1 ou 2, 3 max)
ses répertoires contiennent les docs
une doc peut contenir plusieurs fichiers :
version html, pdf, ps, tgz... fr, us... v1, v2...
ainsi une doc est un répertoire particulier
les noms de ces répertoires terminaux sont précédés par un _
permet de faire la différence avec les répertoires de rangement
---------------------------------------------------- dossiers
constitué d'une arborescence de dossiers de rangement
(6 à 10 top-dossiers, puis 2 à 3 niveaux, 4 max conseillé)
les fichiers ne sont pas placés directement dans ces dossiers
---------------------------------------------------- docs
pour cela, il existe 2 autres types de dossiers :
- ceux dont le nom commence par un _
- ceux dont le nom commence par un #
les premiers portent le nom d'une doc, et contiennent celle-ci
une doc peut avoir plusieurs fichiers (versions, formats, langues...)
les versions consultables en lignes (plusieurs fichiers html)
sont placées dans un sous-répertoire (pas de préfixe spécifique)
le sous-répertoire devrait contenir un fichier index.html
les docs en vrac...
----------------------------------------------------- ex
/ressources/internet/asp/
/ressources/internet/html/
/ressources/internet/html/css/
/ressources/internet/html/#vrac/
/ressources/internet/html/_débutant/
/ressources/internet/html/_guide/
/ressources/internet/html/_references/
/ressources/internet/html/_references/ref/
/ressources/internet/html/_references/ref.tgz
/ressources/internet/html/_references/ref.pdf
asp, html ou css sont des dossiers de rangements pour l'arborescence
#vrac est un dossier pouvant contenir plein de documents quelconques non triés
_débutant, _guide ou _references contiennent une documentation
par exemple, la documentation _references contient une version pdf du doc,
ainsi qu'une version html (plusieurs pages dans un sous-répertoire) et une
version tgz (vraisemblablement une archive de la version html)
eviter certains caractères !
surtout ceux interprétés dans les urls : %/#?&
|