Koha, what is it?
How can you help?
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295151/1000020100000B1E0000075DF33E90FD.png)
Who am I?
- Kai Tahu, Kati Mamoe, Waitaha
- BSc Compsci, BA Maths and Māori Studies
- One of the original Koha developers
- Working at Catalyst IT
- Documenation manager for the 17.11.x branch
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/1258724/5128212886_432a66117d_z.jpg)
CC-BY-SA Kristina D.C. Hoeppner
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
- Started in September 1999 as a y2k fix
- Went live January 3 2000
- 1.0 released June 2000
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
What is Koha?
- 17,776,764 lines of code (including translations)
- 1000s of features
- 0ver 10,000 installs
- 50+ support companies
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/1271700/opac.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/1271727/opac2.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/4037757/goethe.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/1258736/map.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
Anthony Mao Lins - By Permission
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
CC-BY-SA Ramón
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/1268300/5585299033_83ba252eae_z.jpg)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
Paul Poulain - By Permission
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/1269143/1405369380_43b1fc1212_z.jpg)
Chris Hammond Thrashor
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/1269165/14349596012_c22ba90d1d_z.jpg)
Koha Gruppo Italiano
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/1269169/7936329610_806760de98_z.jpg)
Delhi Public Library
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/1268304/15398529979_5b67ef9ab5_z.jpg)
Tomas Cohen Arazi - By Permission
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/1268308/7162934703_d59c7e7889_z.jpg)
Nicole Engard
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/4037798/nigeria.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/1269160/11978646763_31fa0c76e1_z.jpg)
CC-BY-SA Kristina D.C. Hoeppner
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
CC-BY-SA Kristina D.C. Hoeppner
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/1269155/16105131067_04ca9feec0_z.jpg)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
- From 4 libraries in the Horowhenua to 15,000+ around the world
- Automating libraries never before automated
- Facilitating access to information
- Providing employment
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/ranginui/images/698834/5026716018_80b8b4af2e_z.jpg)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
That's great, but now what?
Write documentation, that's what
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
Sphinx
Sphinx uses reStructuredText as its markup language, and many of its strengths come from the power and straightforwardness of reStructuredText and its parsing and translating suite, the Docutils.
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/4037897/olddoc.png)
Docbook XML
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/4037913/newdoc.png)
Sphinx
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
Easy - Editing with gitlab
The easiest way to contribute to the manual is making your changes using the following workflow with gitlab. You don't have to download or install anything for this to work, it can all be done in the browser!
- Gitlab account:
- Navigate manual files: Once you are logged in, you can navigate to the Koha manual on gitlab and get yourself a bit familiar with it's file structure.
- Start editing: Once you have located the file you want to change, you can use the Edit button on top of viewed file to start the editing process.
- Save your changes: Saving your changes will create a merge request to be seen by the documentation team. You can see your open merge requests on your gitlab account.
Check out this video for a demonstration on how to edit using gitlab!
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
Advanced editing
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/4037957/atarau.png)
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
Tasks
- Fix broken links due to changes in headings and anchors
- Fix capitalisation (should follow guidelines for the Koha interface everywhere: first word and names are capitalised)
- Document new features
- Document old features
- Remove old/wrong documentation
https://annuel2.framapad.org/p/KohaManualTodo
![](https://s3.amazonaws.com/media-p.slid.es/uploads/65784/images/2295157/1000020100000B2C00000087C370FE21.png)
Questions?
Koha US - Keynote
By Chris Cormack
Koha US - Keynote
- 2,347