Tekninen dokumentaatio on kasvava haaste monelle valmistajalle. Kun tuotteita on useita, kieliversioita syntyy lisää ja päivitystahti kiihtyy, tavallinen toimisto-ohjelmisto alkaa pettää. Tässä tilanteessa monet organisaatiot alkavat tutkia komponenttipohjaisia sisällönhallintajärjestelmiä eli CCMS-ratkaisuja. Tarjolla on useita vaihtoehtoja, ja erojen ymmärtäminen vaatii ensin peruskäsitteiden selkeyttämistä. Tässä artikkelissa käydään läpi, mitä DITA CCMS -työkalut tekevät käytännössä, miten ne eroavat toisistaan ja milloin DoX CMS on harkitsemisen arvoinen vaihtoehto.
Mitä DITA CCMS -työkalut tekevät käytännössä?
CCMS eli komponenttipohjainen sisällönhallintajärjestelmä on erikoistunut alusta teknisen dokumentaation tuottamiseen, hallintaan ja julkaisemiseen. Se eroaa tavallisesta tiedostonhallinnasta tai verkkosivuston julkaisujärjestelmästä siinä, että sisältö ei tallennu yhtenäisinä asiakirjoina vaan pieninä, uudelleenkäytettävinä moduuleina.
DITA puolestaan on avoin XML-pohjainen standardi, joka määrittelee, miten tekninen sisältö rakentuu. Lyhenne tulee sanoista Darwin Information Typing Architecture. DITA-standardin mukainen sisältö jakautuu aiheisiin, joita voidaan koota eri julkaisuihin tarpeen mukaan. Käytännössä tämä tarkoittaa, että sama varoitusteksti tai tekninen spesifikaatio kirjoitetaan kerran ja se ilmestyy automaattisesti kaikkiin asiakirjoihin, joissa sitä tarvitaan.
Konkreettinen esimerkki: kuvittele, että valmistajan tuoteperheessä on kymmenen eri konetta, joilla on yhteinen turvallisuusluku. Ilman CCMS-järjestelmää sama luku kirjoitetaan tai kopioidaan kymmeneen eri manuaaliin erikseen. Kun standardi muuttuu, päivitys tehdään kymmeneen paikkaan. DITA CCMS -ympäristössä turvallisuusluku on yksi moduuli, joka päivitetään kerran ja joka päivittyy automaattisesti kaikkialle.
Keskeisiä toimintoja, joita DITA CCMS -työkalut tyypillisesti tarjoavat:
- Rakenteinen sisällöntuotanto uudelleenkäytettävillä moduuleilla
- Versiohallinta ja muutoshistoria
- Tarkistus- ja hyväksyntätyönkulut
- Käännösten hallinta ja kieliversioiden hallinta
- Julkaisu useisiin formaatteihin yhdestä lähteestä, kuten PDF, HTML ja WebHelp
Miten DITA CCMS -ratkaisut eroavat toisistaan?
Vaikka kaikki DITA CCMS -järjestelmät perustuvat samaan perusperiaatteeseen, niiden välillä on merkittäviä käytännön eroja. Erot näkyvät erityisesti kolmella alueella: käytetyssä DITA-variantissa, käyttöönottomallissa sekä hinnassa ja skaalautuvuudessa.
DITA-variantti: täysi DITA vai Lightweight DITA
Täysi DITA-standardi on laaja ja teknisesti vaativa. Se soveltuu hyvin suurille organisaatioille, joilla on kokeneita teknisiä kirjoittajia ja resursseja hallita monimutkaista XML-rakennetta. Lightweight DITA eli LwDITA on yksinkertaisempi ja käyttäjäystävällisempi versio samasta standardista. Se mahdollistaa rakenteisen sisällöntuotannon ilman täyden DITA-toteutuksen vaatimaa teknistä osaamista.
Esimerkiksi Heretto ja Paligo ovat tunnettuja CCMS-alustoja, jotka tukevat täyttä DITA-standardia tai omia rakenteisia sisältömalleja. Nämä järjestelmät sopivat hyvin organisaatioille, joilla on laaja dokumentaatiotiimi ja vakiintunut DITA-osaaminen. DoX CMS puolestaan perustuu LwDITA-standardiin, mikä tekee siitä helpommin lähestyttävän erityisesti tiimeille, jotka ovat siirtymässä rakenteiseen dokumentaatioon ensimmäistä kertaa.
Käyttöönottomalli: pilvi vai palvelin
Osa CCMS-järjestelmistä toimii yksinomaan pilvipalveluna, osa tarjoaa myös paikallisen asennuksen. Käyttöönottomalli vaikuttaa tietoturvaan, integraatiomahdollisuuksiin ja hallinnolliseen taakkaan. Pilvipohjaiset järjestelmät ovat yleensä nopeampia ottaa käyttöön, mutta joillakin toimialoilla tai organisaatioilla on vaatimuksia paikalliselle asennukselle.
Hinta ja skaalautuvuus
Suuret kansainväliset CCMS-alustat hinnoitellaan usein laajamittaista yrityskäyttöä varten, mikä tekee niistä kalliita pienemmille organisaatioille. Monet pk-yritykset tai keskisuuret valmistajat löytävät itsensä tilanteesta, jossa tarvittava toiminnallisuus on olemassa, mutta hintataso on suhteeton todelliseen tarpeeseen nähden.
DoX CMS vs. muut CCMS-järjestelmät: rinnakkaisvertailu
Kun DoX CMS:ää verrataan muihin markkinoilla oleviin CCMS-ratkaisuihin, kuten Herettoon tai Paligoon, erot hahmottuvat selkeimmin neljän tekijän kautta: tekninen lähestymistapa, käyttäjäkokemus, hinnoittelu ja tuki.
Tekninen standardi
Heretto on täyteen DITA-standardiin perustuva järjestelmä, joka tarjoaa laajan XML-editorin ja monipuoliset integraatiot. Se sopii organisaatioille, joilla on vakiintunut DITA-osaaminen ja tarve hallita erittäin laajoja dokumentaatiorakenteita. Paligo puolestaan käyttää omaa rakenteista sisältömalliaan, joka muistuttaa DITA:a mutta ei noudata sitä täysin. DoX CMS perustuu LwDITA-standardiin, joka on avoin, kevyempi ja helpommin omaksuttava, mutta silti riittävän rakenteinen moduulipohjaisen dokumentaation hallintaan.
Käyttäjäkokemus ja käyttöönotto
Täyden DITA:n mukainen järjestelmä vaatii usein pitkän perehdytyksen ja teknistä osaamista. Paligo on tunnettu suhteellisen matalasta oppimiskäyrästään, mutta se on suunniteltu ensisijaisesti ohjelmistodokumentaation tarpeisiin. DoX CMS on rakennettu erityisesti teollisuuden teknistä dokumentaatiota varten, ja sen käyttöönottoprosessi sisältää henkilökohtaisen koulutuksen sekä käytännön tuen. Järjestelmä toimii selaimessa ilman paikallista asennusta, mikä tarkoittaa, että koko tiimi pääsee käsiksi dokumentaatioon mistä tahansa.
Hinnoittelu
DoX CMS:n perushinnoittelu alkaa kiinteästä kuukausimaksusta, johon lisätään käyttäjäkohtainen maksu. Tämä tekee kustannusrakenteesta ennakoitavan ja skaalautuvan. Suuret kansainväliset alustat hinnoitellaan usein tapauskohtaisesti, ja kokonaiskustannus voi nousta merkittävästi, kun otetaan huomioon käyttöönotto, koulutus ja ylläpito. DoX CMS:n kohdalla käyttöönottomaksu kattaa perehdytyksen, eikä erillisiä konsultointikuluja synny samalla tavalla.
Tuki ja kehitys
DoX Systems on suomalainen yritys, joka on toiminut teknisen dokumentaation parissa yli kolme vuosikymmentä. Tuki on suomenkielistä ja käytännönläheistä. Kansainvälisten alustojen tuki on usein englanninkielistä ja saattaa kulkea tikettijärjestelmien kautta, mikä hidastaa ongelmanratkaisua erityisesti kiireellisissä tilanteissa.
Kenelle DoX CMS sopii parhaiten?
DoX CMS on suunniteltu erityisesti teollisuuden ja valmistavan teollisuuden teknisen dokumentaation tarpeisiin. Se sopii parhaiten organisaatioille, jotka tuottavat monimutkaista teknistä dokumentaatiota, kuten huolto-ohjeita, asennusmanuaaleja tai varaosakirjoja, useille tuotteille ja useilla kielillä.
Erityisesti kolme käyttäjäprofiilia hyötyy DoX CMS:stä eniten. Ensinnäkin valmistajat, joilla on laaja tuoteperhe ja tarve hallita dokumentaatiota useissa kieliversioissa ilman toistuvaa uudelleenkirjoittamista. Toiseksi dokumentaatiopalveluita tarjoavat toimistot, jotka tarvitsevat tehokkaan yhteistyöalustan useille asiakkaille ja projekteille samanaikaisesti. Kolmanneksi pk-yritykset ja keskisuuret valmistajat, jotka ovat kasvaneet ulos toimisto-ohjelmistoista mutta joille suurten kansainvälisten CCMS-alustojen hinta ja monimutkaisuus ovat este.
DoX CMS ei välttämättä ole oikea valinta organisaatiolle, jolla on jo vahva täyden DITA-standardin osaaminen ja tarve integroida järjestelmä laajaan kansainväliseen dokumentaatioekosysteemiin. Tällaisessa tilanteessa täyden DITA-tuen tarjoava järjestelmä voi olla perustellumpi valinta. Mutta useimmille suomalaisille ja pohjoismaisille valmistajille, jotka etsivät käytännöllistä, edullista ja hyvin tuettua CCMS-ratkaisua, DoX CMS tarjoaa tasapainon toiminnallisuuden, helppokäyttöisyyden ja kokonaiskustannuksen välillä.
Jos olet arvioimassa CCMS-vaihtoehtoja dokumentaatiotiimillesi, DoX Systems tarjoaa maksuttoman suunnittelukonsultaation. Voit ottaa yhteyttä ja käydä läpi organisaatiosi tarpeet ennen minkäänlaista sitoutumista.