Koha Test Wiki Canasta - March 2024
One of a series of test instances for migrating the Koha Wiki MediaWiki database.
For the current Koha Wiki, visit https://wiki.koha-community.org .Documentation meeting 25 October 2023
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
- 25 October 2023, 11:30 UTC (check the date and time in your timezone)
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
- Find bugs to document
- Bugzilla search for Keywords=Manual, Component=Documentation
- Bugs marked with Needs documenting status
- How to edit the Manual