Documentation meeting 27 March 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

Apologies

Add your name here if you would have liked to attend but can't make it.

  • David Nind

In attendance

6 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 and summer. UPDATE: one planned for April.
  • Aude and Caroline to update the automated screenshot project guidelines to take into account Jonathan's latest work. DONE
    • Next step will be to analyse another 100 or so "easy" images. ON HOLD
  • Content Development Guide
    • Aude to add a mention of the Google developer documentation style guide and rework section 1. Style guide. STILL TO DO
    • David to add what we decided about the FAQ page. Status: Still under action
  • Philip to start checking how accessible the Koha manual is in terms of colour contrast, font weight, etc. STILL TO DO

What the team has been working on

  • ...

Ongoing projects

  • Automated screenshots (Jonathan, Caroline, Aude) - Bug 34076
  • Re-organising the manual (David Nind) - Bug 32391 Status: Still under action (had issues getting the left-hand navigation working correctly, think I solved now)

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?
  • Questions to cover (please add yours too!)
    • 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

  • ...

Reminders

Minutes

Next meeting

Wednesday 24 April, 15:00 UTC

Retrieved from "https://wiki.koha-community.org/w/index.php?title=Documentation_meeting_27_March_2024&oldid=33672"