Documentation Team - Drop-in sessions

Introduction

These are informal sessions to discuss or work on anything related to Koha Documentation. This could cover the work flow for contributing to the Manual, processes, and anything you would like to know (we may not always have the answers!)

Upcoming sessions (2025)

Where

• On JitsiMeet by following this link.
• Jitsi Meet is an open source video conferencing platform. On a desktop computer, simply click the link above to open in a browser. On a mobile device, you may prefer to open the link in the Jitsi Meet app.

When

• Wednesday 14th May 14:00-16:30 UTC (check the times in your timezone)
• Tuesday 15th July 13:00-15:30 UTC (check the times in your timezone)
• Thursday 18th September 13:30-16:00 UTC (check the times in your timezone)

What

• Organisers: Aude Charillon and Philip Orr (aude_c and krimsonkharne on the Koha Mattermost) on behalf of the Koha Documentation team.
• Informal drop-in sessions.
• The aims are:
  • for new Documenters to learn to edit the Manual and/or get help;
  • for experienced Documenters to have time set aside to document, ask questions and chat with others;
  • to get more people to edit the Koha Manual - so it becomes more exhaustive and more useful for everyone in the community!

Previous sessions (2023–2024)

Where

• On JitsiMeet

When

• Friday 1 December 2023, 12:30-15:30 UTC
• Tuesday 23rd January 2024, 14:00-17:00 UTC
• Wednesday 14th February 2024, 14:00-17:00 UTC
• Friday 19th April 2024, 14:00-17:00 UTC
• Tuesday 30 July 2024 12:30-15:30 UTC
• Friday 18 October 2024 13:00-16:00 UTC
• Thursday 12 December 2024 14:00-17:00 UTC

Original sessions (2022)

Organiser: David Nind (contact on IRC davidnind)

Times

• Friday, 18 November 2022 at 18:00:00 UTC Date and Time
• Friday, 25 November 2022 at 09:00:00 UTC Date and Time - cancelled
• Friday, 2 December 2022 at 18:00:00 UTC Date and Time

Notes:

• If the times don't suit, let me know, and I can reorganise.
• I will see if alternating the times between Europe and the US is useful.
• Email me at david AT davidnind DOT com if you would like a session outside these times, we can sort out a mutually workable time!

Potential topics

Sessions will be informal - add anything you want to know about:

• Any questions
• Live editing (if no other topics)
• Editing using the GitLab web interface - see [session slides and video]
• Editing using a local Git repository and text editor (Git and editor setup)
• Git commit messages
• reStructuredText
• Current structure of the manual
• Images
• Writing tips, style guide, content development guide

To do

Things to do following sessions:

• Create a more structured programme for learning how to contribute to the documentation:
  • Overview of the process (base of previous presentations by Chris, Katrin and Caroline)
  • Using GitLab for single and multiple changes
  • Using a local editor and copy of the repository (using Git for version control)
  • reStructuredText tutorial
  • Content development guide topics (styles, word list, processes, content types, and so on)