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 (2024)

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

• Thursday 12 December 14:00-17:00 UTC (check the time 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 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

• Friday 1 December 2023, 12:30-15:30 UTC (check the time in your timezone)
• Tuesday 23rd January 2024, 14:00-17:00 UTC (check the time in your timezone)
• Wednesday 14th February 2024, 14:00-17:00 UTC (check the time in your timezone)
• Friday 19th April 2024, 14:00-17:00 UTC (check the time in your timezone)
• Tuesday 30 July 12:30-15:30 UTC (check the time in your timezone)
• Friday 18 October 13:00-16:00 UTC (check the time in your timezone)

Original sessions (2022)

Join at https://meet.jit.si/KohaDocumentationTeam (Google Chrome or Chromium browsers supported, no installation required, access to camera and audio requested when you join). (Happy to use Zoom if people prefer).

Organiser: David Nind (contact on IRC (davidnind) or david@davidnind.com)

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)