dokumentointi

Ohjeiden kehittämistä xAPI-datan avulla

Kirjoittelin aiemmin hieman leikkisästi kahden avoimen standardin, Experience API:n (xAPI) ja Darwin Information Typing Architecture (DITA) “seurustelusuhteesta”. Ilokseni törmäsin sitten konkreettiseen caseen, jossa näitä asioita oli alettu tuoda yhteen. Toimitusketjun hallinnan ratkaisuja tuottavan Llamasoft-yrityksen Learning Experience Designer Andrew McGuire tiimeineen oli soveltanut xAPI-rajapintaa ymmärtääkseen paremmin online-ohjeen loppukäyttäjien toimintaa. Ilokseni sain Andrew’n Skypen päähän ja juttelimme …

Ohjeiden kehittämistä xAPI-datan avulla Lue lisää »

Rakenteisuus on robotin ruokaa

“Laita perustat kuntoon, niin pääset vaikka avaruuteen.” Tällainen tiivistyksen tiivistys tuli päähäni, kun olin antanut STVY:n (Suomen Teknisen Viestinnän Yhdistys) upean syysseminaarin annin vähän tasaantua. Aiheissa oli kattavasti kaikkea ajankohtaista alaan liittyvää: tekoälyä (AI), virtuaalitodellisuutta (VR), chatbotteja ja niin edelleen. Oli mukava nähdä tuttuja, mutta parasta oli todeta oman ydinosaamiseni olevan edelleen ajantasaista ja sovellettavaa. …

Rakenteisuus on robotin ruokaa Lue lisää »

Minimalismi on sisältöjen konmaritusta

Mitä minimalismi tarkoittaa teknisessä viestinnässä? Kerronpa heti alkuun, mitä se ei ainakaan tarkoita. Ensimmäisessä koskaan dokumentoimassani käyttöohjeessa oli vaatimattomat 22 steppiä. Siinä kerroin loppukäyttäjälle kaiken mahdollisen erään ohjelmiston yhdestä toiminnallisuudesta, varmuuden vuoksi. Myöhempi minäni on ymmärtänyt, että tällä ei ole paljoakaan tekemistä minimalistisen ilmaisun kanssa. Mutta millä on? Onko kyse ainoastaan siitä, että siivotaan sisällöistä …

Minimalismi on sisältöjen konmaritusta Lue lisää »