Yksilähteistäminen

Yksilähteistäminen (single sourcing) on teknisen dokumentoinnin menetelmä, joka mahdollistaa sisällön tehokkaan käytön monessa eri muodossa. Sisältö luodaan modulaarisena dokumenttina tai muuten sellaisessa muodossa, että se voidaan ohjelmallisesti julkaista eri formaateissa ilman merkittävää uudelleenkirjoitusta. Yhdestä lähteestä voidaan koota esimerkiksi painettu paperiohjekirja, käytönaikainen ohje, koulutusmateriaali tai verkkosivu.
Yksilähteistäminen säästää aikaa ja rahaa vähentämällä päällekkäistä työtä. Se lisää dokumentaation käytettävyyttä ohjaamalla yrityksen dokumentoinnin standardointia ja helpottaa tekstien kääntämistä ja lokalisointia.

Sisällön luominen

Yksilähteistämisprosessin pohjana ovat modulaarinen dokumentointi ja rakenteinen kirjoittaminen. Yksilähteistämisprojekti aloitetaan kuten mikä tahansa teknisen dokumentoinnin projekti: määritellään kohderyhmä, tarvittava informaatio ja projektiin sopivimmat dokumenttityypit. Varsinainen kirjoitustyö eroaa kuitenkin perinteisestä dokumentoinnista merkittävästi. Perinteisessä dokumentoinnissa jokainen dokumentti kirjoitetaan erikseen, kun taas yksilähteistämisessä kirjoitetaan modulaarinen sisältö kerran ja siitä kootaan ohjelmallisesti erilaisia dokumentteja eri julkaisuformaatteihin.
Yksilähteistäminen voidaan toteuttaa monilla erityisesti siihen kehitetyillä ohjelmistotyökaluilla. Ohjelmistoista on kuitenkin hyötyä vain, jos sisältö on luotu modulaarisesti. Yksilähteistäminen on siis metodologia, ei teknologia.

Moduulien nimeäminen ja organisointi

Valmiit moduulit nimetään ja otsikoidaan yksilöllisesti niin, että ne voidaan tunnistaa ja ymmärtää missä tahansa kontekstissa ja millaisessa tahansa sisällysluettelossa. Loogisina tunnisteina voidaan käyttää esimerkiksi DITA-moduulien id-tunnisteita tai muita dokumentin metadata-tunnisteita.
Kun moduulit on luotu, ne järjestetään loogiseen järjestykseen master-dokumentiksi. Toissijaiset moduulit integroidaan linkittämällä ne ensisijaisiin moduuleihinsa, ja ensisijaiset moduulit ryhmitellään aihepiireittäin.
Moduuleja voidaan ehdollistaa julkaisua varten. Moduulin metatietoihin voidaan määritellä tietty julkaisumuoto tai kohdeyleisö, jolloin lopullista dokumenttia luotaessa tietty moduuli joko otetaan automaattisesti mukaan tai jätetään pois.

Moduulien linkittäminen

Modulaarisen sisällön linkitys auttaa lukijaa löytämään tiedon mahdollisimman nopeasti. Tavallisesti lukijat silmäilevät teknistä tekstiä sen sijaan, että lukisivat alusta loppuun.
Jotta navigointi onnistuisi helposti, käytetään runsasta tekstin sisäistä linkitystä, sisällysluetteloita, asiasanahakemistoja ja muita viittaussuhteita.
Riippumatta julkaisumuodosta kaikissa dokumenteissa on sisällysluettelo, joka esittää dokumentin rakenteen listaamalla kaikki ensisijaiset moduulit.
Aakkosellisten hakemistojen avulla käyttäjä voi hakea tietoa nopeasti. Sähköisissä dokumenteissa hakemistoista voidaan hakusanoja linkittää suoraan kyseiseen moduuliin. Lisäksi käytetään kontekstisensitiivisiä opasteita, eli opastetekstejä, jotka tarjoavat parhaillaan tehtävään toimintoon liittyvää informaatiota. Painetuissa dokumenteissa käytetään muita viittauskeinoja, kuten sivu- tai kappalenumerointia.

Dokumenttien luominen

Lopullinen julkaistava dokumentti luodaan ohjelmallisesti. Käytettävä ohjelmisto ja informaatioarkkitehtuuri määrittelevät dokumentin lopullisen ulkoasun.
Ohjelma järjestää valitut moduulit automaattisesti ennalta määrättyjen periaatteiden mukaan muuttamatta sisältöä. Useimmista ohjelmista voidaan julkaista useita eri dokumentti- ja tiedostomuotoja.

Kritiikki

Siirtyminen yksilähteistämiseen ja uuden sisällönhallintajärjestelmän käyttöönotto vaativat usein merkittävän taloudellisen panostuksen ja sen käyttöönotto voi kestää pitkään. Siksi sitä käyttävät pääasiassa monikansalliset suuryritykset, kuten IBM.
Kriitikoiden mukaan yksilähteistäminen toimii vain tietyissä ääritapauksissa ja on liian kallis ottaa käyttöön. Moduulien uudelleenkäyttö onnistuu harvoin ilman muokkausta, kirjoittajat harvoin todellisuudessa käyttävät toisten luomia tekstejä, tekstiä pitää yksinkertaistaa liikaa lokalisointia ajatellen ja teksti vanhenee liian nopeasti jotta sitä voitaisiin uudelleenkäyttää tehokkaasti. Lisäksi erilaisiin muotoihin julkaiseminen onnistuu nykyohjelmistoilla muutenkin.