On 2 Jan 2022, at 19:27, Martin Srebotnjak <[email protected]> wrote:
Jean et.. al.,
I took a look at the complete pdf and it looks good. As a macOS user I
would prefer this guide than the Linux/Windows-oriented "generic"
guide ...
I do see where Jean is trying to help the user (which is what
documentation
is about) - macOS users are a bit left out by using guides where there
is a
small note on the bottom of page 3 and then the keys not marked on
their
keyboard are mentioned more than 100 times throughout the book. That
is
very user-unfriendly. Now, geeks know about these keys and might not
even
need such a basic, GS guide. But we are talking about users needing
these
guides - i.e. not familiar with the concept of an office suite,
editing
documents, creating slides, adding formulas to sheets, printing ...
I also see what the others replied - but I do not see this as a
problem for
the documentation project - this is a special guide, it can be
published
alongside the main guides (and if there will not be time and will for
new
ones - the will just not be there). So we could simply add a section
to the
documentation site where this could be published. It would not mess
with
the line of "official", "generic" guides, yet it would serve a
specific
public. "Special guides", "Dedicated guides", "Guide incubator", etc.
From the download numbers and the publishing orders one would be able
to
assess if such guides make sense in the long run for the documentation
team
and if they can be made more automatically from the "generic" guides.
Another possibility would be to add a specific appendix for macOS
users
about printing to all the GS guides. Others have mentioned in this
thread
that this is the real difference between the OS', yet no one proposed
any
solution to this gap in usability of the guides - don't the macOS
users
deserve proper printing instructions in the GS guides?
To sum it up: can't we support Jean's effort, make a difference with
the
"regular" guides in presenting it to the public and base our decision
on
the success of the guide?
Ilmari, could you please elaborate: what do you intend to patch
regarding
the help build?
Happy 2022,
Martin
V V ned., 2. jan. 2022 ob 13:18 je oseba Ilmari Lauhakangas <
[email protected]> napisala:
On 2.1.2022 13.44, Olivier Hallot wrote:
Em 02/01/2022 06:38, flywire escreveu:
On Sun, Jan 2, 2022 at 1:09 PM Jean Weber <[email protected]>
wrote:
... Would the team like to have this book as part of the
documentation
set? I am unlikely to update it very often, and I am unlikely to
produce a macOS edition of any other books except possibly the
Getting
Started Guide - if I have time.
There should be a better way to meet the needs of mac users than a
macOS
edition in
https://documentation.libreoffice.org/en/english-documentation/.
Other applications manage to produce one set of docs for different
OSs, even if linux screenshots look a bit strange to say Windows
users. It
will leave mac users with a general feeling of discontent there are
no
current guides for their application/language. I suggest it should
be
independent of current guides and the documents should be reviewed
in
the
context of better meeting macOS needs.
The whole guide preparation process is pretty impressive. Maybe
OS-specific
keys and screenshots could be scripted in future guides for custom
editions
but I doubt it is justified.
If we add a control variable that hides or show sections/paragraphs
depending on the OS, documents will go into a very complex and
fragile
management scheme where mistakes (e.g. deletion of a controlled
paragraph) are easily introduced and unnoticed. Debugging a long
document like our guides will be unpleasant at best.
Technically speaking, LibreOffice has all tools for document
management
(version control, fields, track-changes...) but our team must get
used
to and it is also a entry barrier for newcomers.
The Help has a control scheme (<switch>, <switchinline>) for macOS
where
Ctrl key is changed to Command key and the menu "Tools-Option" is
changed to "LibreOffice - Preferences". Those are 99.99% of all
differences in Help between OS versions.
In the future I will try a Help build patch where the
switch/switchinline are ignored. I suggest to add the macOS-specific
information into the guides rather than produce separate guides.
Ilmari
--
To unsubscribe e-mail to:
[email protected]
Problems?
https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more:
https://wiki.documentfoundation.org/Netiquette
List archive:
https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy
--
To unsubscribe e-mail to:
[email protected]
Problems?
https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more:
https://wiki.documentfoundation.org/Netiquette
List archive:
https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy
