Documentation meeting 25 October 2023

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

9 people in total

Updates

See previous meeting.

Review of action points

  • All to continue with the automated screenshots project (shared folder). It's ok to pick which lines you want to do; we need more "random" images done to validate the idea.
  • Lucy and Aude to log a Documentation bug about expanding the Notices section and to start working on it.
  • Aude to add to the agenda for the October meeting: reviewing / discussing what what should be in the Manual and what belongs to the Wiki. DONE
  • Aude to get back to David Nind about bug 32391 - Reorganising the manual on behalf of the team. DONE
  • Aude to raise bugs about the searching issues in the Manual (missing description in search results and not landing to the right place in the page when clicking on a link in the search results). DONE GitLab issue 34 and Bug 34947

What the team has been working on

  • ...

Ongoing projects - updates

  • Automated screenshots
  • One manual (to rule them all) - Bug 34955
  • Re-organising the manual (David Nind) - Bug 32391
  • Migration to Weblate (Joubu)
    • Switch "master" to "main"
    • Remove old git branches (postpone)
    • Merge the PO files into a single PO file (main.po)
    • Remove the PO files from koha-manual repository, use koha-manual-l10n instead.
    • Adjust the manual documentation for translators
    • Setup a cronjob to update koha-manual-l10n (every change/day/week/month/release ? Also depends on the time it takes)
    • Update the html/epub[/pdf?]

Documentation workflow: issues and ideas

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.

Anything else

  • Roles for 24.05 - time to add your name to the Documentation team for the next Koha development cycle!

Reminders

Next meeting

29 November 2023, 14:00 UTC

Minutes

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