Doc team meeting minutes 2018 -11-28

Wednesday November 28th2018, at 19:30 Berlin Time

Presents:Dave Barton, Drew Jensen, Olivier, Cathy Crumbley, Sophia
Schröder + unknown (connected to minutes only)

Fall back chat:
https://irc.documentfoundation.org/?settings=#libreoffice-doc

TDF Jitsi room
https://jitsi.documentfoundation.org/tdfdocteam

Completed Action Items:
    
    + Proposal for the future LibreOffice documentation development
workflow (Dave)
    Dave: My proposal for the workflow would be:
        - Run conversion script on the last edition of each chapter to
be worked on.
        - Apply the new template to the converted chapter.
        - Updated the chapter's technical content.
        - Final stage chapter cleanup & review.
    Dave:

  * Complete the old -> new styles conversion list for Drew's script (Dave)

  * Complete the 2nd. draft of the 6.x template (Dave)

  * The first item is somewhat interdependent on the second one, but
    both are reasonably close to completion

  * Create the conversion script (Drew)

+ Enter images in document (Cathy)
AI: Clarify the image anchoring (olivier)
     +File with comments on assembling a master document for Guides
         https://nextcloud.documentfoundation.org/s/g3o4wLRJcPcB34P
     +Quote on images:
       "Bug
https://bugs.documentfoundation.org/show_bug.cgi?id=86322prevent images
with character anchors to display in 
       Master Document. As results, the frame with caption only displays
the caption with no image. Nevertheless the frame 
       keeps the size of the original image, even if invisible.
         
       To circumvent: For each image inside the chapter, anchor the
image to PARAGRAPH inside the frame.
       Select the image in the frame, click mouse button 2, select
Anchor, choose To Paragraph.
       An extra paragraph may (or not) pop at the top of the caption
inside the frame. Just delete it."

Pending:
    
AI: Emails developers to get more clarifications (Drew)
     + Appendix on CPU issues for Calc (threading, OpenCL)

+ What happen with the wiki page "Other Resources"? See the discussion:
https://listarchives.libreoffice.org/global/documentation/msg12533.html

Agenda+ Discussion: 
    * Help pages
        + [I]: Added some extension to the XML to make Help edition
easier (olivier)

* Python Help pages
        + Added entry pages for Python scripts documentation (olivier)
        + Need skilled volunteers to fill contents

* Guides:
        + Create the conversion script (Drew)

  * AI: Update Contributors Guides with changes from Dave? (Drew)

  * Yes.

* Long editing session turns LO slow and unusable (Cathy)
         + Some crashes. 
         + Confirmed by 3rd party on the large amount of changes (blog
post - Cathy)
         + get feedback sooner to accept/reject changes, shrink the file
(drew)
         + May use online version to get it faster/easier for review
(drew, olivier)

* Contents of the Guides (Cathy)
         + Shall we review the contents of each chapter
            + some contents too basic
         + Let's survey a broader audience on what must go to inside the
Guides (all)
            + Use TDF survey (olivier)
AI          + define the right set of questions for the contents (olivier)
            https://nextcloud.documentfoundation.org/s/8JKKSzxji2WwXH4

Next meeting WednesdayDecember5th2018, at 19:30 Berlin Time

During the meeting there was some discussion about FAQs & HowTos
(Tutorials) and how to build a collection of the same. For years these
have been available, although somewhat neglected, on the documentation
wiki at: https://wiki.documentfoundation.org/Documentation

Some time ago I requested infra to add these to the Documentation
website pages, with the result that they were added to the side panel
of: https://documentation.libreoffice.org/en/english-documentation/ A
subsequent update of that page appears to have removed those links.
Consequently those links are not readily visible to people visiting the
Documentation website pages.

Rather than overload the guides with FAQ' & Tutorials, maybe we should
work on updating these wiki pages and add appropriate links in the guides.

Just a thought.

Dave

From another thread on ML currently
(Wiki page "Other Resources")
<snip>
// lots of good stuff at
https://wiki.documentfoundation.org/Documentation
https://wiki.documentfoundation.org/Documentation/Third_Party_Resources
<snip>
// and interesting stuff here
"I was still pondering how to organize things when I got side-tracked by
other things, but you can see what I was thinking at the time on the
Documentation
talk page <https://wiki.documentfoundation.org/Talk:Documentation> and my
user
page <https://wiki.documentfoundation.org/User:Khanson679/Wiki_cleanup>."

There is a bunch of reference material.

It might be as easy as the 'more' button on the
documentaiton.libreoffice.org page reference either the documentation page
on the wiki or the Third Party Resources page?

Drew