[Koha-docs] Documentation Team - IRC meeting this week and a general update

[David Nind]

Hi everyone.

Thanks for those volunteering to be part of the documentation team for the
22.05 release cycle - It's great to have you as part of the team!

*Next IRC meeting*

I've set up a meeting for the end of this week, 9 December 2021, 16:00 UTC
- this will be the first documentation meeting for a while.

The agenda is available at
https://wiki.koha-community.org/wiki/Documentation_IRC_meeting_2021-12-09 -
please add any agenda items for things you would like to discuss.

I found it a bit difficult to come up with a time that accommodates most
people (from Europe, Canada, USA timezones) from what I know of the time
zones team members are in - if having it earlier (or later) would mean that
more could make it, I'm happy to change it (as long as I actually wake up!).

If this week doesn't suit, I'm happy to move it to next week (although that
might clash with any KohaCon 2021 events that are on)..

Please let me know if you would like the date or time changed, otherwise I
will go ahead with it as it is, and we can adjust the time for future
meetings.

*General update*

Firstly, my apologies for the lack of activity and communication for the
last release cycle (21.11) - I was originally going to have plenty of time
available to work on the documentation, but unfortunately it didn't work
out that way.

So for this cycle we have the 21.11 changes to incorporate into the manual
as a starting point. To identify what documentation changes are required I
have setup a spreadsheet  - linked from bug 29473
https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29473 I'm
progressively working my way through the list - there were quite a few
architecture and other changes in this release that don't affect the
documentation, so it is not as bad as it first appears.

I have setup the same spreadsheet for 22.05 on bug 29460
https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29640

Using a spreadsheet is probably not the best way to manage release
documentation tasks, but I hope this will help initially.

Other things I've been working on:

   1. Tidying up the Documentation Team pages on the wiki linked from
   https://wiki.koha-community.org/wiki/Koha_Documentation_Team
   2. Setting up tasks in Bugzilla for current GitLab issues, projects, and
   any other tasks I can think of - hopefully I will have this finished by the
   time of the meeting.
   3. Working on my plan to change our approach from a monolith narrative
   style manual, to a more more modular, topic-based approach - the first step
   is for me to setup a prototype so you can see what I mean, and for us
   decide whether this is a better (but more challenging) approach, or not
   (see the documentation plan for initial details of this). I've talked about
   this in the past, but not made much actual progress (see my last
   presentation about this
   https://drive.google.com/file/d/1TWnsuh2Vts6wJA4PyEKh2Sio0AXaSrYR/view?usp=sharing
   )
   4. Thinking about adding a "What's new" section - basically a more
   "librarian friendly" list of new features, enhancements, and things fixed -
   that eventually links to the updated section(s) in the manual. I've created
   bugzilla task
   https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29649 - feel
   free to comment on whether you think this would be a good idea, or not.
   Hopefully it will make it easier for Koha Community members to identify
   what's new in a release, and save some of the work that is repeated by
   support providers (or at least create a good starting point!).
   5. Setup "Office hours" or drop-in session times - this is an experiment
   to see if it will be useful having a time where you can drop-in and ask any
   questions, discuss or just cjhat about any issues to do with documentation
   - we'll see how it goes. For details see
   https://wiki.koha-community.org/wiki/Documentation_Team_-_Office_hours

That's probably enough for this update - I intend to do a weekly (or
perhaps fortnightly) update during the 22.05 release cycle, so let me know
if this will be useful and anything you would like to see covered or
included.

David Nind | david at davidnind.com
387 Whartons Road, RD 10D, Oamaru 9492
p. +64 3 4395 306 | m. +64 21 0537 847
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.koha-community.org/pipermail/koha-docs/attachments/20211207/dd09dead/attachment.htm>