Bonjour Dominique,
Dominique Pautrel a écrit :
Bonjour,
J'ai procédé à un "remaniement" - en accord avec Clayton Cornell et
Sophie Gautier cependant - des catégories du Wiki :
http://wiki.services.openoffice.org/w/index.php?title=Special%3ACategoryTree&target=FR%2FDocumentation&mode=categories&dotree=voir+l%E2%80%99arborescence
En anglais, le message (et la discussion avec) de Clayton est ici :
http://documentation.openoffice.org/servlets/ReadMsg?list=dev&msgNo=5444
Il n'y a pour l'instant que des pages sur les trois modules (Base,
Calc, Draw) à être renseignées.
Exemple avec les fonctions de Calc :
http://wiki.services.openoffice.org/wiki/Category:Calc/Fonctions/FR
J'ai vu que tu avais déjà fait un très gros travail. Bravo.
Le seul truc qui me gène (un peu) c'est la catégorie :
-> Calc/Fonctions/FR
Pourquoi ce n'est pas par exemple FR/Fonctions/Calc
-> Je suppose que cela est du à l'organisation des catégories au niveau
international ?
Pensez vous comme moi que la visibilité de la documentation puisse
être accrue ainsi ?
Sans aucun doute.
(j'ai même envie de rajouter: Pourquoi nous en étions nous passé
jusqu'alors ?)
Manque de courage :-)
Mais il resterait beaucoup à faire... (sans parler des trois autres
modules, plus la section "Generale", où je pense continuer...)
notamment :
1- *Une page wiki par document téléchargeable (ou même tuto externe)*
C'est peut-être lourd de créer une page de wiki pour chaque document. Il
faudrait peut-être se limiter à une page par catégorie de documents ?
-> D'un autre coté, cela donne plus de souplesse dans l'affectation des
catégories
A mon avis, avant de te lancer dans ce travail il faudrait recenser la
charge de travail que cela représente et ne pas hésiter à demander de
l'aide sur cette liste.
Ainsi pour chaque document, son titre, sa date de dernière
modification, un court descriptif, le lien - avec le poids du fichier
- et la catégorie qui va bien. Ceux-ci seront alors mieux visibles
dans le Wiki. On pourra faire référence à cette page qui n'aura besoin
d'être actualisée que si le fichier change (de contenu, de place).
1a- Prenons l'exemple de la nouvelle version de la documentation de
l'éditeur d'équations. Une telle courte page présentant le document
munie de la catégorie [[Category:FR/Documentation/Math]]. Dès lors ce
guide devient visible et les utilisateurs (dont je fais partie)
finiront par savoir que dans ces rubriques ils pourront trouver les
derniers documents. :-)
1b- Un autre exemple, de Pierre-Yves Samyn: "débuter à partir d'une
application exemple commentée" sur le forum. Une page Wiki à l'adresse
[[FR/Documentation/How_Tos/Base/Debuter_Application_Exemple]] affublée
de la catégorie [[FR/Documentation/Base]], et voilà. Excellent
document accessible facilement depuis le Wiki :-)
2- *Nom d'une ou deux branches dédiées*
Il y a des catégories que je ne saurais créer aujourd'hui, ce sont
toutes celles qui concernent les différents langages et interfaces,
car je m'y mélange encore trop les crayons, des mots clés aussi divers
que Macros, Uno, API, Basic, Java, etc. Certains me parlent, d'autre
moins.
J'envisage pour l'instant:
* FR/Langage/Basic
* FR/Langage/Cpp
A la place de langage je mettrais plutôt "Programmation" ou
"Développement" ou plus simplement "Dev"
Mais faudrait-il des catégories comme
* FR/Documentation/Macros
Le fait de rajouter "Documentation" alourdit la catégorie et n'est pas
forcément utile dans ce cas.
* FR/API
* FR/Uno
* FR/Java ou FR/JRE ou même FR/Documentation/JRE ou que sais-je?
Je ne pense pas mais sans en être vraiment convaincu que les catégories
"API" et "Uno" soient indispensables car à partir du moment que tu es
dans la partie programmation, tu es forcément dans l'API et tu utilises
"Uno"
Personnellement, je créerais une catégorie principale pour tout ce qui
touche au développement :
- FR/Dev
Et les sous-catégories suivantes :
- FR/Dev/Basic
- FR/Dev/Java
- FR/Dev/C++ ou Cpp
Et éventuellement
- FR/Dev/API
- FR/Dev/Uno
Mais bon à mon avis il faut également poser cette question sur les
listes anglophones et voir ce qui existe déjà comme catégorie dans les
autres langues.
On peut très facilement lister l'intersection de deux (ou plus)
catégories. Par exemple une requête DPL peut n'afficher que les pages
appartenant à la fois à FR/Documentation/Macros, FR/Langage/Basic et
FR/Documentation/Writer. Elle listerait ainsi certaines macros en
basic pour Writer... ou pourrait en récupérer d'autres en prenant
plutôt pour troisième catégorie FR/Documentation/FAQ/Writer...
Ce qu'il me manque dans ce deuxième point c'est un (ou deux ?) nom(s)
de "super-catégorie" ? (à l'instar de la catégorie
FR/Documentation/FAQ, qui contient, en sous-catégories, chaque FAQ.)
Il faudrait qu'un ou deux mots puissent regrouper logiquement les
autres...
3- *J'oublie forcément quelque chose*
:-D dans l'attente de vos retours,
Bein voilà le mien :-)
Encore bravo pour ton travail
A bientôt
Tony
--
Indépendant dans la mise en place de logiciels libres et d'outils de travail
collaboratif. http://infosaone.free.fr
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
