Nykyisen datahub-version kotisivu
Wikin pääsisältö (toistaiseksi): DH-300-prosessit. Lisää sisältöä on tulossa kesän ja syksyn aikana.
Datahubin dokumentaatio siirtyy wikimuotoon
Datahub-järjestelmän dokumentaatio on tähän asti ollut tarjolla ainoastaan ladattavina dokumentteina. Syksyllä 2024 tutkimme kyselytutkimuksella ja asiakashaastatteluilla käyttäjien mielipiteitä dokumentaatiosta. Silloin ongelmakohdiksi nousivat mm. tiedon löydettävyys ja ajantasaisuus sekä dokumenttien suuri määrä. Lisäksi palveluportaalin dokumentaatiosivut koettiin hankalakäyttöisiksi.
Tutkimuksen tuloksiin nojaten teimme prototyypin uudenlaisesta dokumentaatiosivustosta ja keräsimme siitä palautetta hutikuun 2025 aikana. Palaute oli positiivista, ja wikin arvosanaksi tuli 4/5. Tämän perusteella päätettiin ottaa wiki käyttöön Datahubin uutena dokumentaatioratkaisuna.
Wikin sisältö rajautuu toistaiseksi pääosin datahubin DH-300-sarjan kuvauksiin. Tarkoitus on julkaista wikiin uutta materiaalia kesän ja syksyn aikana, kunnes kaikki prosessisarjat löytyvät.
Wiki on toistaiseksi toteutettu vain suomeksi. Jatkossa englanninkielisen dokumentaation on tarkoitus seurata samaa mallia kuin suomenkielisen. Eri kieliversioita ei siis sekoitettaisi samaan työtilaan, paitsi jos jokin tietty info on olemassa vain toisella kielellä.
Ratkaisussamme wikin eri sivustot eli työtilat ovat pysyviä ja niihin päivitetään aina ajantasaiset sisällöt. Täten käyttäjien kirjainmerkit tai linkit eivät lakkaa toimimasta (ellei esim. sanomaa ja sen sivua ole poistettu) ja ne johtavat aina päivitettyyn sisältöön. Nykyisen version sivustollta löytyy siis tuotannossa olevan version dokumentaatio myös datahub-version vaihtuessa.
Vanhentuneen järjestelmäversion dokumentaatio on saatavilla kooste-PDF:änä kohdasta Arkisto.
Merkittävät muutokset nykytilaan verrattuna:
Wikissä on puurakenne, ja jokaisella kokonaisuudella on oma alisivunsa. Ei ole enää pitkiä dokumentteja. Sen sijaan on monta alisivua, joilla on lyhyempi sisältö.
Datahub voi päivittää tekstejä aina, kun siihen on tarve, ja käyttäjät näkevät, milloin mikäkin sivu on viimeksi päivitetty. Sivujen historiatiedoista näkyy, millaisesta muutoksesta on kyse.
Kun dokumentaation tiettyyn wikisivuun tehdään järjestelmäversiokohtaisia muutoksia (esim. muutetaan sanoman sisältöä eikä vain korjata kirjoitusvirhettä tai vastaavaa), sivulle jää kyseisen dh-version “leima”. Täten voi jatkossa seurata vaikkapa tietyn prosessikuvauksen muutoshistoriaa järjestelmäversioittain: prosessiin on tullut muutoksia dh-versioissa 2.4 ja 2.5, mutta ei versiossa 2.6.
Tulossa olevan version dokumentaatiossa ne tekstikohdat, joissa on muutoksia edelliseen versioon verrattuna, on korostettu värillä. Kaikilla sivuilla, joihin on tullut versiokohtaisia muutoksia, on kyseisen datahub-version leima. Sen avulla pystymme tarjoamaan erillisen koostesivun, jonka alta löytyy vain muutetut sivut (ja niiden kautta muutetut tekstikohdat). Koostesivulla muutokset on myös kuvattu lyhyesti. Uuden version muutettuja kohtia ei siis tarvitse omatoimisesti etsiä koko dokumentaatiosta.
Käyttäjä voi halutessaan viedä wikisivuja PDF- tai Word-muotoon. Datahub tarjoaa myös joitakin valmiita koostesivuja, joissa tietyn kokonaisuuden kaikki alisivut on yhdistetty.
Kynnys kommentointiin on toivottavasti matalampi, kun ei enää tarvitse lähettää erillistä Word-tiedostoa tiketillä. Lisäksi voi reagoida kommenteihin ja käydä keskustelua. Kommentointi vaatii kirjautumisen wikijärjestelmäämme eli Atlassian Confluenceen, mutta on käyttäjille maksutonta.
Wikissä voimme linkittää sisältöä keskenään aivan eri tavalla kuin nykyisessä dokumenttipohjaisessa järjestelmässä.
Nykyisen version dokumentaatio
Wikissä nykyinen järjestelmäversio on 2.4. Tämä versio saa testimielessä toimittaa myös vanhentuneen version virkaa, jotta voimme esitellä wikin ”arkistoidut versiot PDF-muodossa” -toiminnallisuutta.
Hae tästä työtilasta
Äskettäin päivitetty
Lista päivittyy automaattisesti, kun sisältöä päivitetään.
