Documentation meeting 29 November 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

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

In attendance

8 people in total attended the meeting.

Apologies

David Nind

Updates

See previous meeting.

Review of action points

Lucy and Aude to log a Documentation bug about expanding the Notices section and to start working on it.
Aude and Philip to plan online Documentation workshops. DONE
- Scheduled for 1 December and 24 January - see Documentation Team - Drop-in sessions

What the team has been working on

What's new page: see below.

Documentation workflow: issues and ideas

From Koha 23.11, there will be one Koha Manual for 23.11 and future versions (see Bug 34955). We need to agree how to add indications of versions so it's consistent.
- How to say something does not exist or has changed from a later version: Attention note? Example: TrackLastPatronActivity
- How to say something is new from a specific version: Admonition note re-titled Version note? Examples: TrackLastPatronActivityTriggers and SIP2SortBinMapping (scroll down to the Mapping examples. There, ahem, may be more formatting corrections to make in the Use case!!)
- How to highlight these two notes: Caroline is proposing some CSS changes so the Version note has a different colour to other notes. Check out her amazing rainbow of Koha Manual notes (posted in Bug 29712)
- Do we need anything else?
What's new page: what do we want? How do we want it presented? (see https://gitlab.com/koha-community/koha-manual/-/merge_requests/747)
- Caroline started a page so we have a croncrete example to start from (it is published but not part of the Manual menus yet).
Note: we did not have time to cover this section in the meeting; it has been postponed to the next one. What belongs where: this is the question of what belongs in the Manual and what should go in the Wiki (Aude on behalf of others)
- We have had several questions about this recently. It would be good to not only clarify the Manual / Wiki situation but also review what we want the Manual to feature more of in the future (e.g. examples, use cases, workflows...)
- For previous work on this, see Documentation style guide and Documentation - Content Development Guide.

Ongoing projects - updates

Automated screenshots
One manual (to rule them all) - Bug 34955
Re-organising the manual (David Nind) - Bug 32391: merge request to come very shortly (got distracted on some non-Koha tasks...)
Migration to Weblate (Joubu)

Anything else

Planning meetings for the next cycle. Aude is tentatively proposing the following:
- No meeting end of December (unless anyone wants to raise a glass for a happy new Koha year)
- Wednesday 31 January 15:00 UTC
- Wednesday 28 February 19:00 UTC
- Wednesday 20 March 13:00 UTC
- Wednesday 24 April 15:00 UTC
- Wednesday 29 May 13:00 UTC

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 31 January 2024, 15:00 UTC

Minutes