Just the other day, I was trying to get my hands dirty with Koha testing docker. Thanks to two wonderfully uploaded videos from Bywater solutions, some readings in the Koha wiki re: development as well as some help from Koha community IRC, I was able to push that first patch into the Koha ILS bugzilla.
Here are the pertinent resources that help me with my journey:
- The Git book which can be accessed in this URL. Learn how to use Git from this resource. I’ve only read only until Chapter III but it basically helped me move forward with what I want to do in Koha ILS development. This was my starting point in understanding Git. I was able to try Git from way back for testing Github. This book was kind of refresher and the launching pad for what I have to do.
- Various wiki sources from Koha ILS Community:
a. Koha Community’s page about “Get Involved – For Developers” – Contains all the links on what we need in order to start submitting patches.
b.Version Control Using Git – This reinforced what had been discussed from the Git book. But from here I got some clues like I have to clone the public repository as well as how to commit files.
c.Coding Guidelines.
d.Developer handbook.
e.Git bz configuration – The part where submitting of patch is taken care of by Git bz. Installation of this has already been taken care of by the Koha Testing Docker and it will just be a matter of updating some parameters to be able to submit patches to Bugzilla from git. - Two youtube videos from Bywatersolutions
a.Koha Testing Docker – Jessie Cairo (jz) was walk through by Kyle Hall (khall) and Nick Clemens (kidclamp) on how to install Koha Testing Docker in Mac. We were missing some parts in the video since khall and kidclamp already configured jz’s machine, but I guess the part was where they git cloned the Koha ILS repository.
b.Koha Virtual Hackfest – Code Spaghetti streamed live on March 27, 2020 – Here, you will see Nick and Kyle get their hands dirty squashing bugs and go through how Koha ILS development is done. - Installing Docker.
- Installing Docker Compose.
Nos. 4 and 5 should actually be done before installing Koha Testing Docker. I cannot find the resource I used for installing Docker Compose but a simple google search like “Install Docker Compose Debian 9” will lead you to the right direction on how to install Docker Compose but mine is like below:
#Install curl if curl is not yet installed
apt-get install curl
#Install docker - docker.com:
curl -L "https://github.com/docker/compose/releases/download/1.23.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-composeI won’t go into details on the process but if you take a look at the resources I mentioned in nos. 1-4, those will help you a lot in going to Koha ILS development for newbies in going through Koha ILS development process. And as addendum to the resources above, I will add no. 6 below as resource the chat in IRC:
6.Koha IRC chat 2020-08-12 – The time stamp is from 08:16 to 13:04.
That’s all! I hope this post will be able to help those trying to go into Koha ILS Development.