Jean-Francois Nifenecker a écrit :
berlandb a écrit :
Bonjour à tous,
Je crois qu'il est recommandé, si on soumet un projet de How to, de
le signaler par un message. Je viens de proposer un How-to concernant
OOo 2.0 et MySQL sous Windows. C'est assez long (25 pages), mais
l'objectif que je me suis fixé ne m'a pas permis de faire mieux (j'ai
voulu montrer que OOo 2.0 peut aider sérieusement ceux qui
voudraient s'initier concrètement à MySQL).
Merci d'avance à ceux qui voudront bien - malgré la chaleur - se
pencher sur ce travail.
Bonjour Claude,
bravo pour ce travail très intéressant (j'ai appris plein de nouveaux
trucs).
J'ai beaucoup de remarques à faire, mais les deux premières sont des
questions :
[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 ?
[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.
Je pense t'envoyer un peu plus tard le fruit de ma relecture (de
surface tout d'abord) mais voici qq remarques d'ordre général :
Note - Beaucoup de mes remarques sont le résultat de mes goûts
personnels qui, probablement, ne correspondent pas aux tiens.
-- 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...
J'avais d'ailleurs commencé par le cas MySQL et OOo, mais cela retardait
d'autant le démarrage du How to proprement dit.
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.
-- faut-il écrire MySQL ou mysql ? Il faudrait rester homogène et
standard
La base de données de gestion du serveur a pour nom "mysql". Le nom du
système dans son ensemble et du serveur sont généralement écrits "MySQL"
(cela aide d'ailleurs à savoir de quoi on parle). Mais tu as raison, il
faudrait le préciser.
-- 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...
-- 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.
-- 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.
-- attention à la bascule permanente de "vous" à "nous". Un choix pour
l'une seulement est recommandé
Tout à fait d'accord. C'est le fruit de multiples tergiversations. Il va
falloir que je me décide !
-- tu emploies alternativement le présent et le futur. Là aussi, une
homogénéité serait nécessaire
idem
-- 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 !)
-- tu indiques de nombreuses remarques. Je te suggère de les mettre en
valeur par rapport au corps du texte (attribuer un style spécifique)
J'ai pensé un moment à en faire des titres dans le plan du document,
mais je vais envisager aussi ta solution.
-- le modèle de how-to comporte des styles "Liste puce 1" et 2.
Utilise-les à la place de ces horrrrribles puces noires !
Merci de la remarque, je vais en tenir compte
-- 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.
-- 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.
-- les titres de style Titre 2 sont précédés de retours chariot.
Pourquoi ?
idem ci-dessus
-- lorsque tu emploies le style Macro Code, tu devrais retirer la
numérotation des lignes, ici inutile
D'accord
-- il manque la licence en fin de document
De transformation en transformation, j'ai fini par l'éliminer ! Ce sera
rectifié.
Voilà pour commencer ;))
Merci encore et à bientôt,
Merci de cette "première relecture rapide"... si riche déjà.
Claude Berland
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
