Documentation meeting 29 May 2024
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
- Wednesday 29 May, 13:00 UTC (check the date and time in your timezone)
Apologies
Add your name here if you would have liked to attend but can't make it.
- ...
Updates
Review of action points
- See previous meeting.
- Accessibility
- Philip to create a wiki page for his findings. DONE - See Accessibility Issues in the Koha Manual
- Philip to log contrast problems as a GitLab issue. DONE - See GitLab issue 44
- Aude to prepare a shared notepad for non-IRC minutes.
- Marie-Luce and Philip to test the "Start Jitsi Meeting" function in the Mattermost Documentation channel ahead of this meeting.
- Does it work? Can people who aren't on Mattermost join?
- If ok, use this function for the next meeting.
- Aude to close GitLab issues 8 and 42, and remove mentions of a PDF Manual on the Koha community website. DONE
- Caroline to move the MarcEdit section of the manual to a wiki page.
- Indexing of old manuals in search engines
- Caroline to flesh out the options, ready for us to vote on at the May meeting.
What the team has been working on
- ...
Ongoing projects
- Automated screenshots (Jonathan, Caroline, Aude) - Bug 34076
- Re-organising the manual (David Nind) - Bug 32391
- Accessibility issues in the Manual (Philip and team) - Wiki page
- GitLab issue 44: colour contrast
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?
- Caroline added some instructions to Documentation style guide.
- Aude re-organised / simplified the content development guide.
- 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?
- Point to guide on how to write good alt text
- ...
- Use cases: how can we include more of these to better show how Koha features are used together?
Anything else
- ...
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
To be decided