Documentation meeting 28 February 2024

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

Wednesday 28 February, 19:00 UTC (check the date and time in your timezone)

In attendance

7 people in total attended the meeting.

Updates

Review of action points

See previous meeting.
Philip and Aude to plan further Online Documentation workshops for the spring, with the first one in February.
- Do we still need to make a poll for each meeting? We seem to have a good idea of what times work for most people now.
Aude and Caroline to update the automated screenshot project guidelines to take into account Jonathan's latest work.
- Next step will be to analyse another 100 or so "easy" images.
Style guide to become a standing item on the agenda. DONE

Ongoing projects

Automated screenshots (Jonathan, Caroline, Aude) - Bug 34076 Not discussed today
Re-organising the manual (David Nind) - Bug 32391

Documentation workflow: issues and ideas

...

Content Development Guide

Ongoing work to build a Documentation content development guide.

Anything recently added to the page that people want to review or discuss?
New questions to cover
- Should the FAQ items be dated? (Should anything else be dated?) (Aude)
- Use cases: how can we include more of these to better show how Koha features are used together?
  - Formatting; where to insert them (new chapters or sections needed?)
- Screenshots
  - Do we need a recommended image size / resolution?
  - When is a screenshot needed / not needed?
  - Point to guide on how to write good alt text

Anything else

Aude can't make the next meeting date (20th March) anymore. Would anybody like to volunteer to chair or should we move the date to the following week?

Reminders

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

Minutes

Next meeting

~~Wednesday 20 March, 13:00 UTC~~ Wednesday 27 March, 14:00 UTC