Tikettien tekeminen ja kommentointi - KohaSuomi/Koha GitHub Wiki

1. Tiketin teko-ohje

Tikettejä tekevät vain kimppojen pääkäyttäjät.

Tiketit tehdään Koha-Suomen Koha-repositorioon Issues-välilehdellä New issue -kohdasta. Valitse onko kyseessä tukipyyntö, virheilmoitus vai kehitysehdotus.

Hae aina ensin löytyykö samasta aiheesta jo tikettiä. Koska ihmiset kirjoittavat saman asian monella eri tavalla, kokeile muutaman kerran erilaisia termejä. Kokeile myös hakea harvemmilla sanoilla tai pelkästään yhdellä termillä, ja käy sitten läpi tulosjoukosta samankaltaiset tai samaa tarkoittavat tiketit.

Jos löydät jonkun muun raportoimana saman ongelman/kehitysehdotuksen, kommentoi ja kannata tätä ongelmaa. Tarjoa lisätietoja jos sinulla niitä on.

Jos ongelmaa ei ole vielä raportoitu, tee silloin uusi tiketti New issue -napin kautta.

Jos ongelma liittyy jollain tavalla toiseen tikettiin mainitsemalla tiketin numero kuvauksessa tai kommentissa. Esim. "#1".

Pääsääntöisesti vain yksi ongelma/asia per tiketti. Megatikettejä on mahdoton seurata ja edistää, joten pyri pitämään tiketin pyyntö yhdessä asiassa.

1.1 Uuden tiketin luominen

Muista uutta tikettiä tehdessäsi, että tämä on ainoa oikea tapa tuoda esille oma pyyntösi. Kun ilmaiset itseäsi selkeästi, pyyntöäsi on helpompi käsitellä mahdollisimman vähillä lisäkysymyksillä.

Nyrkkisääntönä tiketin kirjoittamiseen ja kommentointiin:

• Mitä olit tekemässä? Kerro esim. sivun URL, linkki asiakaan tietoihin (ei kirjastokortin numeroa), nimekkeen biblionumber (tietue id), niteen viivakoodi, hankintakorin basketnumber (korinumero), raportin numero.
• Mitä olisi pitänyt tapahtua?
• Mitä kuitenkin tapahtui?
• Korjausehdotus, jos sinulla on sellainen.

1.2 Tietoturva

Koska kirjastoissa käsitellään asiakkaiden henkilötietoja, on hyvin tärkeää, että niitä ei laiteta julkisesti esille. Jos otat kuvakaappauksia, huolehdi ettei niissä näy asiakkaiden henkilötietoja joko rajaamalla ne mahdollisuuksien mukaan kuvan ulkopuolelle tai peittämällä tiedot kuvankäsittelyohjelman avulla. Myöskin erilaisia liitteitä koskee sama sääntö. Tietoturvallisia tapoja viitata asiakkaaseen on esimerkiksi borrowernumber tai linkki asiakastietoon.

2. Tiketin kommentointi

Muista, että myös kommentit ovat julkisia, joten älä lisää kommenttiisi mitään salassa pidettäviä tietoja, kuten asiakkaiden nimiä, yhteystietoja tai laina- ja varaustietoja. Paras keino viitata tiettyyn asiakkaaseen on laittaa linkki asiakkaan tietoihin (mene Kohassa asiakkaan tietoihin ja kopioi selaimen osoiterivin osoite).

Kolme kultaista sääntöä kommentoinnille:

• Kirjoita kommenttisi asiallisesti ja ammattimaisesti.
• Pysy asiassa, älä rönsyile muihin ongelmiin.
• Perustele mielipiteesi.