Hello Martin
Thanks for aswering.
Hi,
if you are asking about the guides, the guides were updated to the latest
release versions as seen on the publications wiki, i.e. Getting Started
Guide was recently released for 5.0. It needs updating to 5.1. All the
work-in-progress can be tracked on the odfauthors.org site. Dedicated
module guides were mostly released for the 4.x series so they might not be
so much up-to-date.
I'm glad to get your summary.
IMHO GS is the most important guide as it is the entry level guide and it
is mostly required by any public administration or large deployment where
LO wants to be present - it is the proof that documentation exists and is
up-to-date. And of all the guides this one is the one that l10n teams do
and probably should devote most resources to localize (if they do not have
resources to localize all).
Indeed. There seems to be a concensus that the english GS is the base
for translations.
The GS guides do not cover all aspects of LO, and they are not intended to.
Agree.
For that there are special guides for modules. So the GS guide is updated
and checked for errors with every update and I believe that Jean and her
team did a good work (as much as I could see from localizing the updated
strings), so I guess there are no known errors nor are there really missing
topics in GS50. It just needs to be updated to the latest release(s).
And thus my question: what are the topics introduced in the software
that needs documentation writing? If there is a list somewhere, then
fine, and I'd like to see it. If there is'nt, then ok I'll try to write
one.
With 5.1 (and upcoming 5.2) there was/is a lot of menu restructuring going
on in LO so the updaters will have a lot of work with updating the menu
paths and with updating the screenshots (where menus are present), so the
5.1 update of GS guide will not be so much in adding content but in getting
it true to all the changes. And with all those menu changes LO really does
not have a truly up-to-date general or module-specific guide (LibreOffice
Base Handbook might be the only exemption, because there were no radical
changes in Base).
Indeed
So I guess it would help to set priorities and the teams that will work on
those priorities. And we, the l10n teams will have something to localize
again ...
There is a wikipage that shows the tasklist for the Guides[1].
I see that the GS guides are quite updated and have been carried well
given the resource limitations.
The modules guides concerns me because they are lagging behind
LibreOffice development.
For these modules guides I plan to write a wiki page with the topics x
version that are missing. That way we will have a roadmap on producing
contents, that will come along the update of the existing guides.
If there are objections to this initiative, please let me know (It may
be a very large job to carry).
[1]
https://wiki.documentfoundation.org/Documentation/Development/UserGuideTasks