Date: prev next · Thread: first prev next last
2020 Archives by date, by thread · List index

Hi Peter,

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
Contributors Guide

Best Regards

-------- Original Message --------
From: Peter Schofield []
Sent: Saturday, October 24, 2020, 09:45 UTC
To: Dave Barton
Cc: LibreOffice
Subject: [libreoffice-documentation] Contributors' Guide

Hello Dave

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.

Peter Schofield

To unsubscribe e-mail to:
Posting guidelines + more:
List archive:
Privacy Policy:


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.