The fact is that the Contributors Guide has not been properly updated
from Jean's excellent original since we moved from ODF Authors to
NextCloud. There has been some "piecemeal" editing over the last couple
of years, which is why I now want to work with you and any of our other
long term contributors to produce an updated and accurate guide that
will be meaningful and useful for our new contributors.
I found the same confusing "Organized by a Committee" structure for
Chapter 3 that you have found with Chapter 2. In my current update of
Chapter 3 I simply edited what we already had, just to "get the job
done", but I will be returning to totally rewrite/restructure Chapter 3
I agree that the Contributor Guide should be formatted in the same way
as the user guides, even if some of the introductory content is not
really appropriate for an internal document like this. For consistency
we should apply the Version 7.x template to the Contributors Guide, but
the content of this guide has no relevance to version 7.0 of the software.
I propose that with the help of any other long term contributors, to
fully update and finalize *ALL* chapters of the Documentation
-------- Original Message --------
From: Peter Schofield [mailto:email@example.com]
Sent: Saturday, October 24, 2020, 09:45 UTC
To: Dave Barton
Subject: [libreoffice-documentation] Contributors' Guide
I have being going through Chapter 2 of the Contributors’ Guide and it definitely needs updating
despite only being reviewed earlier this year.
The info is out of date when compared to LibreOffice 7.0.
This chapter has not been transferred to the latest template for user guides. The contributors’
guide should also use the same template as the user guides for consistency.
The way the chapter has been written provides a very confusing message. Any instructions or
advice are not very clear or logical.
What are thoughts on these problems? I am updating this chapter and making a lot of changes to
look similar to user guide.
I think the other chapters need a good once over so that we have a good contributors’ guide.
To unsubscribe e-mail to: firstname.lastname@example.org
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Impressum (Legal Info)
: 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