Hi Cathy,
Thanks very much for working on this. I note that you have put your
files into the LO Authors 5.3 Writer Guide "Feedback" folder. Jean
Hollis-Weber put a fair amount of time and effort into drafting a number
of the chapters for what was to be the 5.3 Writer Guide, but since we
are now working on the 6.0 guides, it seems highly unlikely that the 5.3
edition will go to publication.
I have now created the "Draft" and "Feedback" folders for the 6.0 Writer
Guide. Could you please retract (delete) your chapters 1 & 2 files from
the 5.3 "Feedback" folder and put them into the 6.0 "Drafts" folder for
review.
As to raising the issue of unclear or even misleading wording in the
help files, my _*guess*_ would be, that for very specific entries in the
help files you could raise an issue on Bugzilla:
https://wiki.documentfoundation.org/QA/BugReport
or contact Oliver for assistance.
Always keep in mind the help file is intended more as an "aide memoire"
for users who have some measure of familiarity with the software, rather
than a detailed guide. Obviously, there will be some of the same content
in both, but since they serve a different purpose and a different kind
of readership they are not duplicating information. My personal opinion
is that the In-Built Help and Documentation should never become one and
the same. As a long term, relatively experienced, user of the software
there I times when I look to the help files for short simple pointers to
help me get something done. There are way too many software packages out
there that force me to dig through a mountain of irrelevant "guff" to
find those short simple pointers.
Traditionally the In-Built Help and Documentation were handled
separately. Comparatively recently the project management decided to
bring both under the umbrella of the documentation team. As I mentioned
in another post, Oliver has done a lot of work to make it easier for
people not familiar with the help system file structure to work on the
help system. For more information go to:
https://wiki.documentfoundation.org/Documentation
and look at the various "Help" related entries under the "HELP PRODUCE
documentation" section.
Best Regards
Dave