berlandb a écrit :
[1] Question sur la forme : pourquoi as-tu créé ton document au format
OOo v.1 alors que tu y chantes les louanges (justifiées) de la v2 ?
Parce que je me suis dit que ce serait bien que les louanges de la
version 2 puissent être lues par ceux qui ne l'ont pas encore installée
! Erreur de calcul ?
Mmmmm... Même si ton point de vue se défend, je ne peux m'empêcher de
penser qu'en V2 se serait "mieux" :)
[2] Question sur le fond (et sa réponse détermine le contenu du
document) : quel est le public visé ? Des connaisseurs de MySQL que tu
veux amener à utiliser OOo comme frontal ? Des utilisateurs d'OOo qui
ne connaissent de bases de données que Calc ?
Il me semble -- à la lecture du document et pour moi ignorant de MySQL
-- que la réponse à cette deuxième question n'est pas claire.
J'ai essayé de le dire dans le titre "objectif de ce document". Je
voudrais atteindre le public utilisateur de OOo qui désire s'initier à
l'utilisation de MySQL (base de données relationnelle à larges
possibilités, accessible du fait qu'elle est du domaine du "logiciel
libre"). J'ai moi même fait partie de ce public (et j'en fais encore
partie). J'ai conclu de mon expérience que sans un How to du genre de ce
que j'ai cherché à faire, on risque fort de préférer travailler
directement avec le client fourni avec le serveur MySQL (sans OOo), car
il y a de bons bouquins sur MySQL.
J'ai donc écrit ce How to pour qu'on n'abandonne pas - par manque de
documentation - l'objectif de travailler avec MySQL sous OOo.
Dans ce cas, qui est donc proche de ma supposition "Des utilisateurs
d'OOo qui ne connaissent de bases de données que Calc", je commencerais
le doc par :
1. Qu'est-ce que MySQL ?
2. Pourquoi utiliser MySQL avec OOo ? (en d'autres termes, pourquoi
préférer MySQL au module Base ?)
même si çà allonge le document, ces points me semblent essentiels à
développer si tu veux amener des OOo-tistes à MySQL (sinon ils resteront
sous Base)
En passant, troll du mercredi : MySQL est-il vraiment un "logiciel
libre" ? ;)
-- le premier schéma est incompréhensible pour qui n'est pas
connaisseur de MySQL (c'est mon cas ;) Selon la réponse à [2], il
faudra soit le retirer soit l'expliciter soit le simplifier.
-- même remarque pour le schéma présentant MySQL et OOo dans un réseau
Je tiens absolument à ces deux schémas car ils permettent de justifier
toute la démarche du How to.
On dit qu'un bon dessin vaut mieux qu'un long discours. Les miens ne
sont peut-être pas bons...
Il y a quelques mois, j'ai fait un premier essai. Je donnais des
explications... mais c'était trop long...
Peut-être que les schémas agrémentés d'un commentaire... :)
Sincèrement, en l'état, ils me rebutent et, débutant en bases de
données, je me dis "encore une doc pour les pros de la Base de données,
c'est pas pour moi". Et je risque donc de ne pas dépasser le premier
quart de la première page, ce qui serait vraiment dommage compte tenu du
contenu du reste du doc.
J'avais d'ailleurs commencé par le cas MySQL et OOo, mais cela retardait
d'autant le démarrage du How to proprement dit.
C'est en effet ce qui arrive. Néanmoins, un démarrage en douceur assure
la fidélité du lecteur (çà c'est un slogan, tiens !)
Pour l'instant je vois donc ces dessins comme un moyen d'aider le
lecteur à faire sa propre synthèse sans tout lui exposer en détail.
Mmmm... A toi de voir. Je maintiens, que, en l'état, je passe dessus
sans (essayer de) les déchiffrer. Mais c'est ton how-to et ce n'est que
une seule opinion.
-- je trouve les flèches rouges dans les copies d'écrans plus gênantes
qu'utiles : le lecteur doit savoir... lire ;)
Certaines au moins sont à revoir. Ceci dit le (bon) dessin est un moyen
d'expression qui me paraît efficace...
Entièrement d'accord. Néanmoins, je me contenterais de numéros
séquentiels sur les éléments / actions à consulter / réaliser, avec
repères dans le texte.
-- certaines copies d'écrans sont trop petites
J'ai choisi cette solution pour limiter le nombre de pages... Par
ailleurs, OOo permet de faire du zoom si nécessaire.
Mon imprimante ne sait pas (encore) faire des sorties papier qui se
zoument ;)
N'oublie pas que la plupart (si, si, je t'assure) des lecteurs de docs
*vont* les imprimer. A leur décharge, le fait que la lecture ne se fait
pas toujours uniquement dans des circonstances où un écran est
disponible... Les graphiques et copies d'écrans se doivent d'être
lisibles dans ce contexte. Et tant pis pour le volume du doc.
-- la numérotation "standardisée" des chapitres des how-to est
généralement 1. -> 2. etc. As-tu une raison (autre que ton goût
personnel, ce qui en est une excellente :) de choisir A. -> B. etc. ?
Non, que le goût personnel, mais c'est facile à revoir.
OK. Pas de pb. C'est un choix qui se respecte.
-- tu parles très souvent de "root" (et pour cause) sans jamais
définir le terme. En fonction de la réponse à [2] il faudrait
l'expliciter
Le how-to ne peut être un cours même élémentaire sur MySQL. J'ai pensé
que le public visé saurait de quoi il s'agit. Mais j'essairai d'en dire
un mot (moi aussi j'ai horreur de l'emploi de mots jamais définis - si
classique en littérature informatique !)
N'oublie pas que le public visé n'est pas (encore) accoutumé à l'outil.
Lui ressasser les termes n'est pas inutile, je pense.
-- tu parles à plusieurs reprises de télécharger MySQL. Tu pourrais
peut-être mentionner (en note de bas de page, par exemple) le lien
vers le site en question
Le désir d'écourter (et la flemme par ces temps de grande chaleur) m'on
fait aller trop loin.
D'une manière générale, je pense qu'il est intéressant sinon essentiel
de donner une ouverture au lecteur : où trouver des infos
complémentaires, où se procurer les outils, etc. Ces informations
n'alourdissent *jamais* aucun doc.
-- je n'ai pas bien compris l'organisation de tes titres
? J'ai utilisé un modèle de How to fourni par le site openOffice... mais
peut-être pas le dernier. Je vais voir cela.
As-tu utilisé le modèle pour la V2 ?
http://fr.openoffice.org/Documentation/modele/Modele_HowTo.stw
Je vais attendre ta deuxième mouture avant d'annoter, réviser et te
renvoyer en direct mes notes.
Je trouve que tu es sur une très bonne voie et ta démarche "faire
profiter d'une expérience" tout à fait généreuse et ô combien utile.
Nous attendons avec impatience "la suite" ;)
PS : pour ce qui est du volume du document, qui semble beaucoup te
tracasser, il me semble que tu ne devrais pas te focaliser là-dessus.
Laisse "filer" ton document en y incluant ce que tu penses vraiment
utile, sans te censurer. *Après* il sera toujours temps de résumer ou,
mieux, d'organiser de manière que chacun trouve plus facilement l'info
qu'il recherche parmi les 350 pages ;)
PPS : lorsque tu posteras ta mise à jour dans Doc & fichiers, n'oublie
pas de spécifier le numéro de version dans les commentaires.
Bonne soirée,
--
Jean-Francois Nifenecker, Bordeaux
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
