[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [libreoffice-documentation] User guide chapter development workflow
- Subject: Re: [libreoffice-documentation] User guide chapter development workflow
- From: Olivier Hallot <firstname.lastname@example.org>
- Date: Tue, 17 Sep 2019 17:41:50 -0300
- To: email@example.com
The whole process deserves a complete review because it does not fit
with the pace of the development as well as it may not fit 2019 user demand.
The process was rather good for a software release cycle of 12 or more
months and the availability of authors.
I'm thinking to move to a time-based release as with the software.
In summary: At a given deadline, we publish the document/book "as is".
I thought on a monthly or bi-monthy release of the full book(s).
If mistakes or outdated information persist, we fix in the new "release"
as time and availability permits. Release numbering can follow software
This is the ideal world, things may not work so smooth in real world...
Plenty of issues to address...
First, we need to get the book(s) at its latest software release.
Then we must be commited to update the text to follow the releases.
Likely, intermediate releases do not carry changes in the software, only
The update-revision-publish cycle has to go. We keep "update". "Revision
and fixes" shifts to next book release. "Publish" is the latest released
book, of last month.
I imagine the build of the full book to now follow the usage of a
master document, so the build is "automatic", "on-a-click" (*).
The process needs management. No one can manage or coordinate all books,
I suggest one coordinator per book. The community (i.e Authors) may want
to put forward his/her name as coordinator of one of the books.
The "(Book) Guide team" may want to work online directly (i.e no
revision). Updates and new contents is to be written directly in the
chapter stored in the cloud. Trust in Author competences is necessary.
The desktop, NextCloud + LibreOffice online, wiki and websites are the
tools we need to work.
Issues to address...
The fast and continuous update of the books puts a challenge to the
non-English community that wants to translate the books. To be addressed.
The process may frighten newcommers specially people that are not
confident on using LibreOffice. The quality of our publications will
reflect this competences.
We don't have a tool to report mistakes in the books besides mailing
list or direct mail to me. To be adressed.
I stop here for the moment waiting for comments, if we move ahead in
this direction or find another way to get our literature released. Shall
we open a wiki page or cloud document to anotate all ideas?
(*) Today Jean Weber kindly assembles the book by concatenating
chapters and adjusting the contents (e.g. removing the TOC of each
chapter, remove pesky direct formatting left, fix many internal
glitches) and this work takes significant time and effort, which we aim
to avoid. Master documents have their own set of issues too, but with
proper tweak in chapters, I think (wishfull thinking !) it can be faster.
Em 16/09/2019 06:40, Steve Fanning escreveu:
> I am trying to better understand the Documentation Team’s current
> process for developing user guides. I have two objectives - firstly to
> make sure I follow the processes correctly and secondly to update the
> wiki page entitled “Chapter 3 Using the LibreOffice Documentation Team
> Website”. Please note that I’m not trying to change any part of the
> process, simply trying to better understand what we already do.
> I have three questions arising from the existing workflow diagram (see
> https://wiki.documentfoundation.org/File:Workflow.png), which I believe
> reflects the pre-Nextcloud process and may need updating.
> (1) Do we still have four discrete roles in the workflow, i.e.
> Writer, Reviewer, Editor and Publisher?
> (2) My current understanding is that Writer uploads his drafts to the
> Feedback folder in Nextcloud (rather than Draft). Is that correct?
> (3) At what point does the chapter get uploaded to the Draft folder,
> and by which role?
> Thanks for any help.
> Steve Fanning
LibreOffice Documentation Coordinator
Rio de Janeiro - Brasil - Local Time: UTC-03:00
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/
|[libreoffice-documentation] User guide chapter development workflow||"Steve Fanning" <email@example.com>|
- Prev by Date: Re: [libreoffice-documentation] Infra announce: Authenticating against gerrit using TDF's Single Sign-On system
- Next by Date: [libreoffice-documentation] Calc Guide, Chapter 9, Data Analysis
- Previous by thread: [libreoffice-documentation] User guide chapter development workflow