Sisällöntuotanto

Kaikenlaiseen ammattimaiseen tai semi-ammattimaiseen sisällöntuotantoon liittyviä tekstejä. Usein mukana teknisen dokumentoinnin näkökulmaa.

SEO ja saavutettavuus ajavat eri asioita: case ”aivonmuotoinen idealamppu”

Kun saavutettavuusdirektiivi tuli voimaan keväällä 2019, uudistin blogin ulkoasua ja tekniikkaa. Kiinnitin muun muassa enemmän huomiota kuvien alt-teksteihin eli siihen, mitä ruudunlukuohjelma kertoo kuvasta henkilölle, joka ei itse kuvaa pysty näkemään tai jos kuva ei jostain syystä lataudu näytettäväksi. Tuolloin opin mitä alt-tekstit ovat ja mitä ne eivät ole. Tekstipätkän pitäisi kertoa tiiviistii sen, mitä …

SEO ja saavutettavuus ajavat eri asioita: case ”aivonmuotoinen idealamppu” Lue lisää »

Miksi ruohonleikkurin ohjeet ovat vaikeampia käyttää kuin raketin?

En ollut koskaan ajatellut tätä, mutta jos vastaan osuu artikkeli Technical writing in space, niin täytyyhän se lukea. Opin siitä muun muassa, että avaruuskävelyihin on liittynyt paljon teknistä dokumentaatiota jo Apollo-ohjelman ajoista lähtien 70- ja 80-luvuilla. Alkuvaiheessa informaatiota oli mapeissa, nykyään monimuotoisesti sekä sähköisesti että osin myös paperilla. Ohjeet ovat aina olleet tarkkaan testattuja, ajantasaisia …

Miksi ruohonleikkurin ohjeet ovat vaikeampia käyttää kuin raketin? Lue lisää »

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ää »