Documentation meeting 27 September 2023

Place

Video conference meeting using Jitsi at https://meet.jit.si/KohaDocumentationMeeting

We are using an (open source) video conference platform for the discussion part of this meeting. You don't have to turn your camera on if you prefer not to be seen; but if you are able to use a mic it should make our conversations a lot easier!
To join the meeting, click on the meeting link. If you are on a desktop computer, it will open in a browser window; no need to install anything. To join on a mobile device, you will need to download the Jitsi Meet app (from Google Play; from Apple Store).
Browsers will ask for permission to use video and audio devices: check or review these settings if you have audio or video issues.
Supported browsers | Mobile application

We will use the #koha IRC channel (IRC server irc.oftc.net) to record the meeting minutes, including #info and #action information. Feel free to login there too (if you don't have an IRC client you can use your web browser.)

Time

27 September 2023, 14:00 UTC (check the date and time in your timezone)

In attendance

11 people in total

Updates

See previous meeting.

Review of action points

All to give feedback to Jonathan on Bug 34076 - Automated screenshots using Cypress.io testing framework (See also update on screenshots project below).
Aude to email the Koha mailing list to get wider feedback about the "One manual" idea.
Aude to start planning "How to document" online workshops open to all.

What the team has been working on

Documentation workflow: issues and ideas

Automated screenshots project (Caroline, Jonathan, Aude) See:
- Jonathan's talk at KohaCon for full background;
- Caroline's message to the Koha mailing list for latest information.
- Second page of spreadsheet is statistics. On September 21, 4.6% of images had been analyzed (74), of which 43% are hard or impossible (32). Not a big enough sample to determine difficulty of entire manual yet.
Existing notices section of the manual (Lucy, Aude): can we make it look more like the system preferences?
One manual idea (Aude)
- For background, see Aude's message to the Koha mailing list.
- What do we want to do next?
- Note: sphinx extension mentioned by David Liddle on the mailing list to add banners to older manuals https://sphinx-version-warning.readthedocs.io/en/latest/

Anything else

Reorganising the manual (bug 32391): feedback from the Documentation Team, perhaps test with 22.11 (the Long-term support version)? (David Nind)
Search issues in the manual (raised in meeting)

Reminders

Find bugs to document
- Bugzilla search for Keywords=Manual, Component=Documentation
- Bugs marked with Needs documenting status
How to edit the Manual

Next meeting

Wednesday 25 October 2023, 11:30 UTC

Minutes