Keith - Have you looked into using Git with the odt file format. I did a quick search and it seems that Git can only handle a plain text version of the document if you want to see a Diff between two versions. So you could see which words had changed and differences in the grouping of text in paragraphs but things like the formatting of text or arrangement of images with respect to the text could not be tracked through git diff. Of course, changes could be tracked within the odt file, though even that is not comprehensive. For example, changing a paragraph's style does not seem to be captured. Dennis's point about how edits will be coordinated and versions controlled is very important.. I have no experience with technical writing beyond writing drafts and handing them to "the documentation people" to do their magic, so I can't give any really informed advice. The matter does bear some very careful thinking and discussion. Luckily, we will not have to deal with a huge team right away.
regards, Francis On Thu, Jan 14, 2021 at 10:26 AM Keith N. McKenna <keith.mcke...@comcast.net> wrote: > On 1/13/2021 6:17 PM, Dennis Hamilton wrote: > > I don't see an attachment (apart from the digital signature). Is there > a GitHub reposi8tory set up available? > > > > Good news though. > > > > I am curious how the coordination of edits and the use of GitHub version > control will be navigated. I look forward to seeing how that unfolds. > > > > - Dennis > > > Sorry about that. I could claim it was a senior moment, but since you > have a few years on me that one is not going to work. This time I am > attaching it. > > Keith > > -----Original Message----- > > From: Keith N. McKenna <keith.mcke...@comcast.net> > > Sent: Wednesday, January 13, 2021 13:34 > > To: doc@openoffice.apache.org > > Subject: Proposed Process for Documentation > > > > Greetings All; > > After a discussion on legal@, as long as we do not include them in an > > "Official Release" we can use the .odt files for version 3 that are > > stored on the mwiki to bring them up to date for version 4.x.x and above. > > > > Attached is a proposed process utilizing a GitHub repository for version > > control of the User Guides and other Documentation. It is in .odt format > > with changes enabled. Please feel free to edit it and/or make any > > comments you feel are needed. > > > > Regards > > Keith > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: doc-unsubscr...@openoffice.apache.org > > For additional commands, e-mail: doc-h...@openoffice.apache.org > > > >
