On 1/23/2021 2:25 AM, Robert Farrell wrote: > Keith, > > I’d be glad to lend a hand with the Getting Started guides. Tell me what you > need and how you need it. My platform is MacBook Pro MacOS 11.1 (Big Sur). > > Thanks, > > Robert > > Robert Farrell > robertfarr...@embarqmail.com > > > >> On Jan 21, 2021, at 3:25 PM, Keith N. McKenna <keith.mcke...@comcast.net> >> wrote: >> >> On 1/15/2021 1:01 AM, F Campos Costero wrote: >>> 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 >>> >> >> Yes I did. In fact all the revisions of the proposal were done using my >> GitHub account and it worked quite well. It will offer to open the >> binary file in the external application. You are correct that it does >> not handle a diff, but that is not why I was suggesting using it. It was >> simply as this is the version control system that the project has chosen >> to use and trying to implement anything different would require yet >> another VM for the project and the incumbent overhead of finding >> volunteers with the necessary skills to maintain it. >> >> As I am seeing no other comments from the documentation team I am >> planning on writing this attempt off as one more failure on my part. >> >> I will continue on my own to attempt to get a usable 4.1.x and 4.2.x >> Getting Started guide completed. Any help in getting these done will be >> greatly appreciated. >> >> Regards >> Keith >> >>> 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: >>
As there are obviously still conflicting views on how documentation should be handled. I have decided to step away from this entirely and concentrate my volunteer efforts elsewhere. Regards Keith
signature.asc
Description: OpenPGP digital signature
