Date: prev next · Thread: first prev next last


Bonjour Sophie,

Le 21/04/2021 à 11:15, sophi a écrit :

Aparté à propos de ce type de documentation
-------------------------------------------

Je constate que ce type de doc est compliqué à trouver pour un néophyte
(la cible primaire) car (1) dispersé sur le site, (2) variable selon la
langue choisie et (3) présent à des endroits improbables et, à mon avis,
inadaptés.

Compliqué :

Pages FR
Aide > Documentation > Wiki (EN !) > Wiki FR > Macros ->  perdu !
c'est
Aide > Documentation > Wiki (EN !) > Wiki FR > Guides officiels (en bas,
rubrique Antisèches)

Note : le lien Aide > Documentation > "à partir de cette page"
mène directement à la page voulue mais ce lien peu contrasté est noyé
dans le texte et son libellé n'explicite pas clairement ce vers quoi il
pointe.
Tu préfèrerais qu'il y ait un lien vers les macros et un lien vers la
doc générale ?

Ce serait l'idéal.

Je pense qu'il y a deux catégories de personnes qui recherchent de la doc (pas que sur les macros, bien sûr) : ceux qui recherchent une doc particulière ("je veux réaliser un publipostage") et ceux qui vont dans les pages "doc" pour voir ce qui existe et qui pourrait les intéresser ("tiens, il y a un doc qui parle publipostage. C'est quoi ? Voyons").

Ces publics doivent pouvoir accéder à la doc selon ces deux angles. Et cet accès doit être simple et rapide : lorsqu'il faut cliquer puis re-cliquer puis encore cliquer, changer de langue (qui s'en aperçoit ?), c'est beaucoup trop et il y a des chances qu'on ait perdu des visiteurs à cause de ça. On pourrait se dire que si ils ont abandonné c'est qu'ils n'étaient pas trop motivés, mais ça participe du sentiment que LibO serait élitiste et pas pour MMme Toulemonde, juste réservé aux geeks.

Pour ce qui est des macros, nous savons tous que c'est un sujet délicat : "les macros sous LibO c'est compliqué", "on n'y comprend rien", "l'API est touffue", etc. Oui, leur abord est compliqué. C'est une réalité. Il *faut* donc que la doc soit visible.

-> Il est toujours bon (lire : indispensable) de mettre en valeur ce qui existe : le livre de Godard & Marcelly, celui/ceux de Pitonyak, ceux qui existent pour Base, un point d'entrée vers les docs historiques de OOo sur l'API, etc. et que ces docs soient *immédiatement* visibles pour les visiteurs (même lorsque les doc sont en anglais, ils doivent être visibles sur le site FR).

Question au passage : quid des nombreuses docs présentes sur le site OOo en cas de disparition d'iceluy ? Il y a des choses très intéressantes qu'il serait idiot de perdre.



mais aussi
Découvrir > Modèles et extensions > LibreOffice extensions [1] > BASIC xxx

[1] Actuellement cassé, impossible de sélectionner un tag

C'est réparé, n'hésite pas à signaler sur Redmine lorsqu'il y a un bug.
Christian fait encore pas mal de modifications sur le site et cela peut
avoir des effets de bord pénalisants.

Ah, merci. Oui, je pratique Redmine mais c'est un peu lassant d'avoir N outils différents à gérer en matière de rapport de bugs, et j'avoue aussi que j'ai bcp de mal avec le SSO.


Je suis d'accord. Le site principale va bientôt être complètement
modifié. Peut-être que c'est le bon moment pour repenser comment
organiser la documentation si ce qui est en place ne vous convient pas.

Magnifique ! Il y a un vrai travail à faire. Je n'ose proposer de l'aide car j'ai déjà promis... et pas tenu, faute de temps pour le moment :(


Très cordialement,
--
Jean-Francois Nifenecker, Bordeaux


--
Envoyez un mail à doc+unsubscribe@fr.libreoffice.org pour vous désinscrire
Les archives de la liste sont disponibles à https://listarchives.libreoffice.org/fr/doc/
Privacy Policy: https://www.documentfoundation.org/privacy

Context


Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.