Documentation team Meeting Minutes 7/18/2018

Wednesday July 18th 2018, 19:00 CET

Presents: Olivier Hallot, Drew Jensen (connection issues), Dave Barton

Agenda:

* Completed items (Available in the Published folder of ODFAuthors)
GS6000 - Preface - completed Dave Barton
GS6004 - Writer - Completed - Olivier
GS6013 - Macros - completed - Drew
GS6016 - Open Standards - Completed - Olivier
GS6007 - Draw - completed - Johnathan Cohen
GS6008 - Base - completed - Olivier
GS6011 - Gallery, etc.. - completed - Dave Barton
GS6014 - Olivier
          + Added context menus
          + update all menu/toolbar customization dialog
             +adjust text to new dialogs
          + Removed the piece about adding a fax icon in a toolbar
            + who use fax in 2018? + lengthy description

Pending
GS6002 - Almost there, need last reading (Dave Barton)
GS6006 - Impress - Drew

All remaining:
GS6001
GS6003
GS6005
GS6008
GS6009
GS6010
GS6012 - Johnathan
GS6015 -

* Book compilation (olivier)
   + Started a master document
      + Each completed chapter has its "copyright" to "Contents (TOC)"
wrapped in a section
      + use a condition to hide the section: "book eq 1"
      + Variable "book" is defined in master document, when book=1,
chapter's copyright+TOC is hidden
   + Hit issue in displaying images from chapters on master
      + Cause: its a bug.
https://bugs.documentfoundation.org/show_bug.cgi?id=86322
      + To overcome, change image anchoring inside frame to paragraph
in chapters.
         + no big deal, except extensive task
         + changed, preface, ch2, ch4, and on going.

Discussion: (Dave, olivier)
    * Time release of books
        + "perfect is enemy of the good" (Dave)
        + "better something than nothing" (olivier)
        + Set a date for publication
        + deliver what is available
        + update timely with corrections/erratas
        + Book assembly easier with master document
        + Use of NextCloud + LOOL will improve file access and update
           + still need control on who is working on each file
    * Book authoring process
        + Revision of the revision of the revision does not work
           + very unproductive and not fun at all
           + Current LO track changes very hard to read
               + sometimes too fragmented or granular
        + better have highly skilled authors we trust to cut revision
cycle
        + Leave revision to time based erratas
            + Monthly or bi-monthly, or 1 errata per book release.
            + not connected to minor releases of the software (no
feature changes)
        + Published 6.n is draft 6.n+1
        + bring discussion to Doc ML.

NEXT MEETING: Wednesday July 25th 2018, at 19:00 Berlin Time