<div dir="ltr"><div dir="ltr">Hi Hugh.</div><div dir="ltr"><br></div><div>Thanks for the questions!<br></div><div><br></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
After some time away I'm hoping to get involved with the Koha community again. I don't currently work at a Koha-using library, but I still think the project is great.<br></blockquote><div> </div><div>I also don't work at or support a library using Koha - it is a great community and software. Your contributions would be most welcome, whether it is to the documentation or something else!<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">1. When providing updates to documentation aimed at old versions, should the pull request be aimed at a different git branch, or is everything simply merged to 'main' and someone else takes care of backporting documentation?<br></blockquote><div><br></div><div>If the changes can be made to the main branch and can be cleanly merged without any changes for the older versions, then:</div><div>- merge to the main branch</div><div>- indicate that this change should also be made to older versions of the manual as well</div><div>==> basically, if there are no conflicts it is easy for the change to be "cherry picked" into older branches/versions of the manual</div><div><br></div><div>If the change only applies to the older branch (for example, has been rewritten or is totally different in later versions), the merge request should be against that specific branch/version.</div><div><br></div><div>If other changes have been made between the older branch and the main version that would cause a conflict, then separate merge requests with changes specific for each branch/version of the manual is required. <br></div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
2. How are documentation updates tracked between Bugzilla, Taiga, and GitLab? Should I be referencing something in commit or PR messages, and if so, what should I be referencing? There seem to be many Taiga tickets that reference code bugs rather than documentation bugs, for example: should I reference the Bugzilla bug in this case, or the Taiga ticket, or both, or something else?<br></blockquote><div><br></div><div>There are Taiga tasks for each Bugzilla change - these come from the release notes. Caroline goes through and adds any changes from the release notes that require changes to the documentation.</div><div><br></div><div>Here is the guide on how to ideally label commit messages:</div><div><a href="https://wiki.koha-community.org/wiki/Git_guide_for_documentation#Commit_messages">https://wiki.koha-community.org/wiki/Git_guide_for_documentation#Commit_messages</a></div><div style="margin-left:40px"><pre>Taiga [number] ([bugzilla number]): [Short title]

Short paragraph(s) that succinctly describe the change
and why the change was made.
</pre></div>At the moment the GitLab issues are used for more management tasks for generating the documentation, rather than documentation bugs.</div><div class="gmail_quote"><br></div><div class="gmail_quote">Here is a useful starting point for the documentation team <a href="https://wiki.koha-community.org/wiki/Koha_Documentation_Team">https://wiki.koha-community.org/wiki/Koha_Documentation_Team</a> <br></div><div class="gmail_quote"><br></div><div class="gmail_quote">One thing I've been trying to do is bring everything together in a Content Development Guide for the Koha documentation. Ideally, this should make it easier to get up to speed contributing to the documentation and all the different aspects (covering the workflow, terminology, content strategy, and a style guide).<br></div><div class="gmail_quote"><br></div><div><div><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>David Nind | <a href="mailto:david.nind@gmail.com" target="_blank">david.nind@gmail.com</a><br>PO Box 12367, Thorndon, Wellington, New Zealand 6144<br>m. +64 21 0537 847</div></div></div></div></div></div></div></div>