[libreoffice-projects] Documentation Team Meeting Minutes September 2nd 2021 at 18:00 UTC.

Documentation Team Meeting Minutes September 2nd 2021 at 18:00 UTC.

Presents: Laura V., Steve F., Dave B., Olivier

Telegram-group
https://t.me/joinchat/ALeRuUFCxyZY0wzoddldWQ

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

Completed items:

 * Update calc guide formatting for 7.2 (SF)
 * Help pages on new 7.2 features
    - Open Help bugs on many new features(OH)
    - Some of the 7.2 improvements already registered and addressed

Pending items:
AI: Join_The_Doc_Team.odp
    + Will review and enhance it (Dave)
AI: Consider a video (3 min) introducing doc team and doc tasks (OH)

[VN - Vasudev Narayanan] pending discussion

1. Possibility of receiving a build (prior release) for documentation 
testing? This will help immensely to document the instructions, and 
usability. What do you think?

2. A monthly plan of activities or tasks that need to be addressed from 
the documentation team. Maybe a kanban board to enlist important items 
to complete? Volunteers can pitch in to take the task.

News:
    Please register for LibreOffice Conference 2021

    + https://conference.libreoffice.org/2021/registration-form/

Topics and Discussion:
* Some issues in updating Guides
  + Image anchoring
     + AS_ CHARACTER

https://wiki.documentfoundation.org/Documentation/DocumentationTeamInfo/ProducingLibreOfficeUserGuides#How_to_insert_images_into_ODT_files

  + Import images, either
      + Delete old image beforehand and the paste the new image
      + delete the old image and import new image from a file
      + either case, delete old image.
          + When pasting new image over old one produces distortion
          + new image inherit dimensions of old one.

  + Image references:
     + Prefer references as "Category and number"
        + Was only "number" by demand from translators
        + Now machine translation can handle categories
        + I have a script that make the changes in 1 sec (Olivier)
           + can run script upstream (Olivier)

     + Can we avoid "Figure NN on page YY" ?
        + "on page YY" is meaningless in online docs
        + Most reference are hot hyperlinks so click to get to
           the image
        + Eventually use "above/below"
        +  I prefer to keep as is (Steve)
            + has meaning for paper book readers
            + I can manage downstream in online publication (Olivier)
==> Keep as is

     + same for "Title XYZ on page YY"
        + title references are hot hiperlinks
        + use "above/below" is necessary
          + check excessive repetition of above and below in paragraph
        + same reasons as above (SF)
==> Keep as is

     + List cleanup
        + Style "List 1" visually identical as "Text Body" with bullet
          + hard to spot
          + often breaks when applies style change
          + I have a script to clean this (Olivier)
             + Please apply on new revised CG72 chapters
     + Review of Numbered lists
          + open, I have no scripts (Olivier)
          + numbered list are restarted too often

  + Updates of the Calc Guide 7.2
      + Shall we jump to 7.3?
      + No... 7.2 quite ready to publish (Steve)
==> Upload for 1rev of Calc Guide 7.2 soon (Steve)
      + Notebook bar for Calc
         + Write Guide has N.bar described in chap 21 (Olivier)

* Updates on the wiki
     + How to make changes in wiki, can I do it directly? (Laura)
        + we have a discussion tab on each wiki page, use it (Steve)
        + All changes can be reverted by sysadmin (Olivier)

     + Newcommers, please go thru Style Guide for good English tech 
writing:

https://wiki.documentfoundation.org/Documentation/DocumentationTeamInfo/StyleGuide

Meeting ajourned

Next meeting : *THURSDAY* September 16th 2021 at 18:00 UTC.

--
Olivier Hallot
LibreOffice Documentation Coordinator
Rio de Janeiro - Brasil - Local Time: UTC-03:00
LibreOffice – free and open source office suite: https://www.libreoffice.org
Respects your privacy, and gives you back control over your data
http://tdf.io/joinus

--
To unsubscribe e-mail to: projects+unsubscribe@global.libreoffice.org
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/projects/
Privacy Policy: https://www.documentfoundation.org/privacy