Palaute-projektin käyttöohje¶
Tämä sivu on tarkoitettu kaikille Koha-Suomen asiakkaille. Tällä sivulla kuvataan miten annetaan kehitysehdotuksia, virheilmoituksia (bugeja) ja tukipyyntöjä. Palautetta otetaan vastaan vain kimpan pääkäyttäjien kautta eli ole aina ensisijaisesti yhteydessä kimppasi pääkäyttäjään, kun kohtaat uuden ongelman.
- Table of contents
- Palaute-projektin käyttöohje
1. Koha-Suomi ja kehittäminen¶
Koha-Suomi kattaa maantieteellisesti ison osan Suomea, ja palvelee monien kirjastojen yhteistä tavoitetta päästä käyttämään, avoimen lähdekoodin kirjastojärjestelmää. Koha-Suomi tekee kehitys- ja ylläpitotyötä, joka on avointa ja vapaata lähdekoodia, kaikille sen asiakaskirjastoille. Tämä tarkoittaa myös niitä kirjastoja, joissa Koha-Suomen henkilökuntaa ei ole paikalla.
Tästä syystä on ensiarvoisen tärkeää, että kaikki kirjastot käyttävät yhteistä palautteenantojärjestelmää. Toimipisteet, joissa Koha-Suomen työntekijät ovat töissä eivät ole etuoikeutettuja omien huoliensa kanssa.
Kimppojen pääkäyttäjät kirjaavat virheilmoitukset, kehitysehdotukset ja tukipyynnöt Palaute-projektiin ja niitä voi kaikki rekisteröityneet käyttäjät kommentoida ja äänestää. Kehitysehdotusten ääniä käytetään apuna, kun mietitään uusien ominaisuuksien toteutusta ja aikatauluja. Lopullisen päätöksen toteutettavista ominaisuuksista ja aikatauluista tekee asiantuntijaryhmä, hallitus ja toimitusjohtaja/tuotepäällikkö.
Ihan kaikkia kehitysehdotuksia ei pystytä toteuttamaan. Ehdotuksia läpikäytäessä otetaan huomioon mm. seuraavia asioita:
- kaikki kehitystyö pyritään tekemään ensisijaisesti niin, että toiminto/ominaisuus/virheenkorjaus saadaan mukaan yhteisöversioon, jolloin meidän oma ylläpitovastuu pysyy kohtuullisena
- pystyykö toiminnon tekemään jollain jo Kohassa olevalla toiminnolla vähän eri tavalla kuin mihin on totuttu
- löytyykö Koha-yhteisöstä jo toiminnallisuus, joka voisi ratkaista ongelman/tarpeen
- jos kehitysehdotus toteutetaan, viekö se Koha-Suomen version kauemmaksi yhteisön versiota, jolloin Koha-Suomen ylläpitovastuu lisääntyy ja versiovaihdoksessa mukaan otettavien ominaisuuksien määrä lisääntyy. Tällöin on mietittävä, riittääkö kehittäjäresurssi. Samalla mietitään, onko kyseessä ominaisuus, jonka voi saada mukaan yhteisöversioon. Jos kyseessä on pelkästään suomalainen tarve, se on hankala saada yhteisöversioon ja yhteisön ylläpidettäväksi.
2. Rekisteröityminen Redmineen¶
Koha-Suomen Redmineen saat oman käyttäjätunnuksen rekisteröitymällä yläreunan Rekisteröidy-linkistä. Tämän jälkeen saat automaattisest oikeudet projekteihin ja pääset kommentoimaan ja äänestämään tapahtumia. Kohan ohje suomeksi -wikiä sijaitsee julkisessa Koha-Suomen dokumentaatio -projektissa.
3. Tiketin kannattaminen¶
Koha-Suomen yksi tärkeistä päämääristä on osallistaa osakaskirjastojen työntekijät oman kirjastojärjestelmänsä kehitykseen.
Koha-Suomen Redmineä koskee vaalisalaisuus, eli Koha-Suomen työntekijät, eivätkä ketkään muutkaan saa levitellä tietoja siitä kuka on äänestänyt mitäkin tikettiä. Ilman erityisiä oikeuksia ei pääse näkemään äänestystietoja. Jotta voimme estää samojen tikettien uudelleenäänestämisen, sekä pystyäksemme paremmin hahmottamaan eri osakaskirjastojen tarpeita, Koha-Suomen henkilöstöllä on oikeus nähdä millä tunnuksilla mitäkin tikettejä on äänestetty.
Ohjeita äänestämiseksi:- Etsi Redminestä tikettejä. Tämä onnistuu haku-toiminnon avulla, tai selaamalla eri projektien tikettejä. Voit myös saada kaveriltasi linkin johonkin tikettiin jota kannattaa. Tiketit ovat myös luokiteltu eri aihealueisiin kuten Lainaus, Tiedonhaku, Raportit jne. Näkymää voi suodattaa myös niiden mukaan.
- Tiketin tarkassa näkymässä klikkaa Vote-painiketta, jolloin tiketti saa äänesi. Annetun äänen voi myös perua.
4. Tiketin kommentointi¶
Kaikki käyttäjät pystyvät kommentoimaan tikettejä. Muista, että 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). Lue myös kohta "Nyrkkisääntönä tiketin kirjoittamiseen ja kommentointiin" alempana.
Kolme kultaista sääntöä kommentoinnille:
- Kirjoita kommenttisi asiallisesti ja ammattimaisesti.
- Pysy asiassa, älä rönsyile muihin ongelmiin.
- Perustele mielipiteesi.
5. Tiketin teko - ohje pääkäyttäjille¶
- Siirry Palaute - Koha-Suomi tai Kehitysehdotukset -projektiin sen mukaan, 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ä käyttäen. 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 Uusi tapahtuma -linkin kautta.
- Jos ongelma liittyy jollain tavalla toiseen tikettiin, linkitä tiketit toisiinsa Linkitetyt tapahtumat -kohdassa.
5.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.
5.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 liitteitä koskee sama sääntö. Tietoturvallisia tapoja viitata asiakkaaseen on esimerkiksi borrowernumber tai linkki asiakastietoon.
6. Käyttöoikeudet ja ryhmät¶
Redminessä pystyy ylläpitäjä säätämään käyttöoikeuksia ns. roolin mukaan. Tällä hetkellä rooleja ja ryhmiä on kuusi kappaletta, joille on ennalta määritetty tietyt oikeudet. Käyttäjä voi kuulua useampaan ryhmään.
| Rooli/ryhmä | Jäsenet | Oikeudet |
|---|---|---|
| Ylläpitäjät | Koha-Suomen ja Kansalliskirjaston kehittäjät, Koha-Suomen toimitusjohtaja ja pääkäyttäjä | kaikki oikeudet |
| Kehittäjät | Kaikki kehittäjät | mm. tikettien hallinta, projektien hallinta, ei oikeutta käsitellä käyttäjätietoja |
| Pääkäyttäjät | Kimppojen pääkäyttäjät ja tieteellisten kirjastojen pääkäyttäjät | mm. tikettien hallinta, jäsenien hallinta, dokumenttien ja wikin hallinta |
| Työryhmän jäsen | Esim. Asiantuntija- ja kuvailuryhmän jäsenet | Lisäoikeutena dokumenttien ja wikien hallinta muistioiden lisäämistä varten |
| Korkeakoulut | Tästä luovuttaneen lähiaikoina | |
| Jäsen | Kaikki | tikettien kommentointi ja äänestys |
6.1. Seuraajaksi lisääminen¶
Yksittäisiä käyttäjiä tai kokonaisia ryhmiä pystyy lisäämään tiketille seuraajaksi. Toiminnallisuus on kätevä esimerkiksi silloin, kun haluaa lisätä seuraajiksi esimerkiksi kaikki pääkäyttäjät tai kehittäjät. Sitä ei kuitenkaan kannata käyttää ihan kaikkiin tiketteihin, vaan hyvin harkitusti. Seuraajat saavat sähköpostiinsa ilmoituksen, kun tikettiin tulee muutoksia (kommentti, tila vaihtuu yms.). Yksittäinen käyttäjä voi kuitenkin omissa tilitiedoissaan määrittää, ettei saa koskaan viestejä.
Käyttäjä itse voi lisätä itsensä tiketin seuraajaksi oikealta ylhäältä tähdestä, jolloin hän saa ilmoituksen, kun tikettiin tulee muutoksia (kommentti, tila vaihtuu yms.):
7. Yhteistyö¶
Koha-Suomi tekee kiinteästi yhteistyötä Kohaa käyttävien tieteellisten kirjastojen kanssa ja onkin sovittu, että pyrimme tekemään uudet ominaisuudet pääsääntöisesti Koha-yhteisön versioon. Uudet ominaisuudet pyritään tekemään niin, että ne voi halutessaan ottaa käyttöön (esimerkiksi tieteellisten kirjastojen varastotietuetuki). Jos ominaisuutta ei saada yhteisöön ja se arvioidaan välttämättömäksi, mahdollisuuksien mukaan toteuttamaan ne erillisinä liitännäisinä (plugineina) tai mikropalveluina, jotka eivät tee muutoksia Kohan ydinkoodiin.
Yhteistyötä pyritään tekemään aktiivisesti myös Koha-yhteisön kanssa.
Koha-kimppojen pääkäyttäjät tapaavat viikottain verkkopalaverissa ja jakavat tietoa ja kokemuksia sekä tekevät muita asiantuntijatyöryhmän ja antamia tehtäviä.