Hi Other opinions: Yes I have one radically different.
Rationale: the current workflow and available resources is incompatible (IMHO) with speed of software development, the gap between software release and Guide release is very hard to close. I prefer a dynamic "time-release" of the guides, as with the software. That means publish "as-is" at time of release, whatever is available, ideally synch'ing with the software release. Each update will be a "Revision number". I foresee usage of master documents to compile the book periodically and quickly, and chapters updated by trusted Authors. One coordinator per guide. Full usage of track changes and comments. A new challenge for sure, but I propose to select one of our guides and test the new workflow. Olivier Em 07/12/2019 15:24, DaveB escreveu: > > I will add some points about the Documentation NextCloud structure and > how things have become somewhat confused. > > When it was decided move from ODF Authors to NextCloud, I set up the > NextCloud directory structure along similar lines to the one we had on > ODF Authors. Although it was undecided if we needed a Published folder > in the NextCloud structure. It was my understanding that our workflow > would be also be very similar to Jean's original workflow diagram > https://wiki.documentfoundation.org/File:Workflow.png > > It was about this time that we started work on the Calc guide and > somebody arbitrarily decided that copies of the 4.1 guide should be > deposited in the 6.0 Drafts folder. From then on things got more and > more confusing, especially for new contributors. > > I agree with Jean and would advocate that we return to the original > workflow. Other opinions? > > Dave > > On 07/12/2019 10:21, Jean Weber wrote: >> It makes more sense to me for updates (or new chapters) to go in Drafts, >> reviews in Feedback, and finished chapters in Published (the way we >> did it >> in ODFAuthors), instead of the way we’ve been doing it in NextCloud. >> >> Jean >> >> On Sat, 7 Dec 2019 at 03:32 <[email protected]> wrote: >> >>> Hi Dan >>> >>> Documents for review should be in the Feedback folder. >>> I moved them there for you. >>> >>> Kind regards, Kees >>> >>> Dan Lewis schreef op 06.12.2019 17:12: >>>> I have completed editing the preface and chapter 1. These have been >>>> uploaded to the Draft folder. (Is this the correct place, or what >>>> would be a better place to put it?) I have also created a Guide status >>>> spreadsheet based upon the Calc version. I have added one added >>>> column: Replace screenshots. This has been placed in the Base Handbook >>>>> 6.2 folder similar to where the guide status spreadsheet was placed in >>> Calc. >>>> >>>> My next project is to make necessary changes in two of the example >>>> databases that were discussed in the two documents I have uploaded. I >>>> plan to edit one chapter at a time, and as I do so, I will be also >>>> making editing each mentioned example databases. >>>> >>>> In case anyone is interested, I have also created and uploaded ePUB >>>> versions of the preface and chapter 1. They are also in the draft >>>> folder. These are only examples of what is possible with this format; >>>> when each document is ready for publishing, then they have to be >>>> modified based upon any changes are made. >>>> >>>> Dan > > > > -- Olivier Hallot LibreOffice Documentation Coordinator Comunidade LibreOffice Rio de Janeiro - Brasil - Local Time: UTC-03:00 http://tdf.io/joinus -- To unsubscribe e-mail to: [email protected] Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/ Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette List archive: https://listarchives.libreoffice.org/global/documentation/ Privacy Policy: https://www.documentfoundation.org/privacy
