Documentation meeting 28 February 2024

From Koha Wiki
Jump to navigation Jump to search

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

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

Minutes

Next meeting

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