“Kerro minulle… ja unohdan.
Näytä minulle… ja muistan.
Ota minut mukaan… ja ymmärrän.”
- Kungfutse

Anne Gentlen kirja Conversation and Community: The Social Web for Documentation on julkaistu jo vuonna 2009, mutta se on FLOSS Manuals -projektin kannalta luultavasti ainoa relevantti teknistä kirjoittamista käsittelevä kirja, joka on Kindleeni päätynyt. Kirja ei tunnu vanhentuneen parissa vuodessa, vaikka sen käsittelemät ilmiöt kehittyvät todella nopeasti.

Anne Gentle on tekninen kirjoittaja, joka pitää Just Write Click -blogia ja on aktiivinen englanninkielisen FLOSS Manualsin puolella. Conversation and Community perustuu Gentlen kokemuksiin FLOSS Manualsissa ja muissa dokumentaatioprojekteissa ja käsittelee wikejä ja sosiaalista mediaa ammattimaisen teknisen kirjoittajan näkökulmasta.

Loppukäyttäjät eivät välttämättä välitä dokumentaation kirjoittajan ammattitaidosta tai ohjeiden virallisuuden asteesta, vaan etsivät Googlen avulla toimivia ohjeita verkosta. Niinpä käyttäjän kannalta toimivaa dokumentaatiota voivat olla ohjelmistoprojektin virallisten julkaisujen lisäksi keskustelupalstat, wikit, blogit tai postilistat. Lisäksi informaatioähkystä muutenkin kärsivät käyttäjät tahtovat tiedon helposti ja heti.

Paras dokumentaatio perustuu Gentlen mukaan käyttäjien kysymyksiin ja kirjoittamisprojekti kannattaa aloittaa usein kysytyt kysymykset -listasta. Hakukoneoptimoinnista on tullut olennainen dokumentaatiossa tarvittava taito, koska käyttäjät esittävät kysymyksensä ensin hakukoneelle. Gentle opastaa kirjoittajia myös vastaamaan lukijoilleen suoraan käyttäen erilaisia verkon mahdollistamia viestintätyökaluja.

Teknisten keskustelupalstojen osallistujat eivät yleensä ajattele kirjoittavansa dokumentaatiota, vaikka kirjoittavatkin käyttöohjeita näppäimistö rutisten. Tästä ei ole pitkää matkaa yhteisöllisen wikin editoimiseen. Wikin perustaminen ei kuitenkaan takaa yhteisön muodostumista sen ympärille.

Gentle opastaa dokumentoijia rakentamaan yhteisön neljässä vaiheessa. Ensin tulisi kuunnella käyttäjien juttuja verkossa. Toisessa vaiheessa tulee osallistua käyttäjien keskusteluihin. Kolmas vaihe on jakaa sisältöä verkossa. Neljännessä vaiheessa tämä sisältö tarjotaan vuorovaikutuksen ja muokkaamisen mahdollistavalla alustalla.

Dokumentaatiowikien tekijät päätyvät teknisen kirjoittamisen lisäksi toimimaan myös yhteisöjen ylläpitäjinä, jotka joutuvat perehtymään myös erilaisten flame war -tyyppisten ilmiöiden ongelmakenttään.

Kirjassa esitellään myös FLOSS Manualsin käyttämä yhteisöllisen kirjoittamisen booksprint-menetelmä, jossa pyritään saamaan aikaan kokonainen kirja lyhyessä ajassa. Englanninkielisellä puolella pidetään tosin yleensä muutaman päivän extreme-kirjapyrähdyksiä, joissa kirjoittajat kokoontuvat yhteen huoneeseen ja keskittyvät vain yhteen asiaan, kun taas suomenkielisellä puolella olemme yleensä pitäneet hitaampia ja pidempiä booksprinttejä, joissa istuntoja on vain muutama ja suurin osa kirjoittamisesta tehdään verkossa.

Gentlen ammattimaisen teknisen kirjoittamisen näkökulma aiheuttaa välillä jonkin verran hämmennystä. Hänen mukaansa esimerkiksi wikiin on välttämätöntä luoda tyyliopas, vaikka FLOSS Manualsin postilistalla käydyssä väittelyssä monet keskustelijat näkivät pakollisen tyylioppaan vain nostavan vapaaehtoisten kirjoittajien osallistumiskynnystä ja tukahduttavan luovuutta. Käyttäväthän yhtiöt tyylioppaita paljolti juuri estääkseen kirjoittajien oman tyylin näkymisen julkaistuissa tuotteissa. Eri kirjoittajien omien tyylien sijasta lopputulokseksi tulee standardimallista ja minimalistista tekstiä.

Kirjan parin vuoden ikä näkyy ainoastaan siitä, että FLOSS Manualsin uutta Booki-julkaisualustaa ei käsitellä lainkaan. Booki on suunniteltu mahdollistamaan valmiiden tiedostojen tuottaminen lukulaitetta tai painoa varten napinpainalluksella. Lisäksi siihen on FLOSS Manualsin kokemuksien perusteella lisätty yhteistyötä helpottavia sosiaalisen median ominaisuuksia.

Conversation and Community käsittelee tietysti juuri sitä aihepiiriä, jota olen itse viime aikoina paljon harrastanut, mutta sen pitäisi kiinnostaa kaikkia dokumentaatiowikien harrastajia.