Dokumentaatiosta

Tämä artikkeli käsittelee käytännön vinkkejä hyvän dokumentaation tekemiseen. Se on tarkoitettu niille, jotka aikovat osallistua Drachenwaldin kuningaskunnan tiede- ja taidekilpailuun Society for Creative Anachronism-yhdistyksessä. Artikkelini ei edusta Drachenwaldin virallista kantaa tapaan kirjoittaa dokumentaatio, vaan kertoo kokemuksistani dokumentaatioiden kirjoittajana. Isoja kilpailuja voittaneena uskaltaudun näin antamaan ohjeita muillekin.

Mitä on dokumentaatio?

Dokumentaatio on yksityiskohtainen kuvaus työn edistymisestä. Dokumentaation avulla perustelet ratkaisusi työn edetessä vaihe vaiheelta suhteessa autenttisuus/nykymaailma (Opettele tämä lause ulkoa). Se voi olla lyhyt, ranskalaisilla viivoilla koottu tai pitkä kielellisesti rikas kirjallinen tuote. Tärkeintä siinä on selkeä ja harkittu asiasisältö. Sen avulla välität muille viestin siitä, kuinka monipuolisesti ja laajasti tunnet tämän alueen ja tiedät mitä olet tekemässä.

Miksi dokumentoida?

Dokumentaatio on kirjallinen tai suullinen tiedote, joka esitetään Drachenwaldin tiede-ja taidekilpailutöiden liitteenä. Dokumentaatio on hyvä esittää myös tiede- ja taidenäyttelytöiden yhteydessä, samalla tavoin kuin museoiden näyttelyissä on oheismateriaalia katsojia varten. Aina kilpailutöitä tehdessä tulee siis muistaa, että paitsi kilpailussa menestymistä varten, teet työtäsi myös esittelläksesi muille harrastajille osaamisesi aluetta ja ennen kaikkea saadaksesi palautetta ja oppiaksesi lisää. Työlläsi edustat paitsi itseäsi myös omaa paronikuntaasi, pitäjääsi ja kylääsi. On aina positiivista, jos työsi herättää keskustelua. Vaiiket itse pääse kilpailupaikalle vaan lähetät työsi jonkun mukana, voit saada yleisöltä terveisinä vinkkeja uusista kirjoista, toisesta tavasta katsoa asioita jne.

Ilman dokumentaatiota kilpailun tuomareiden tai ulkopuolisten on mahdotonta saada selville, kuinka paljon ja monipuolisesti kilpailija oikeastaan tietää aiheestaan. Oletko vain sattumalta valinnut oikean työtavan, oikean työkalun tai juuri aidon näköiset pistot?

Drachenwald ja dokumentaatio

Drachenwaldin kuningaskunnan virallisissa kilpailuissa dokumentaatiolla on suuri painoarvo. Kilpailulomaakkeesta, jonka jokainen täyttää ennen kilpailua (Kingdom of Drachenwald Arts & Sciences Competition Entry Form), selviää, että dokumentaatiosta saa yhtä paljon pisteitä kuin työn jäljestä. Lomakkeen voi käydä tulostamasta itselleen osoitteesta: http://www.drachenwald.sca.org/files/a&s/criteria/. Lomakkeessa arvostellaan erikseen seuraavat osa-alueet: dokumentaatio (max. 30 pistettä), autenttisuus (max. 20 p.), vaikeusaste (max. 10 p.), työn jälki (max. 30 p.) ja esteettisyys (max. 10 p.).

Samasta osoitteesta löydät englanniksi myös arvosteluperusteet tieteen ja taiteen eri osa-alueille: vaatteille, juomille jne. löytyvät omat arvosteluperusteet. Halutessaan ne voi käydä lukemassa.

Samasta osoitteesta löytää myös minimidokumentaatiolappusen, jonka koko on noin neljännes A4:n paperiarkista (Arts & Sciences Minimum Dokumentation). Siinä pyydetään esittämään nimi ja sca-nimi, työn nimi, maa ja aikakausi, johon työ sijoittuu, mitä tämän aikakauden tyylille oli tyypillistä sekä käyttämäsi lähteet. Kutakin lause tai pari, kaikki noin kokoon A6! Ei kuulosta vaikealta. Mielestäni näin lyhyesti asiat esittäessään on vaikeata saada tuomarit vakuuttuneiksi omasta tietotaidostaan, ja jos suinkin on aikaa, olisi hyvä perehtyä dokumentaation tekoon kunnolla.

Kuinka dokumentaatio kirjoitetaan

Varaa dokumentaation kirjoittamiseen työpäivissä mitattuna viikko. Oletan, että olet lukenut lähdeteoksesi ensimmäisen kerran jo työtä tehdessäsi. Jos työsi on lähdössä Drachenwaldiin kilpailemaan, varaa sen lisäksi aikaa sen kääntämiseen. Moni aarnimetsäläinen on luvannut käännösapua dokumentaatioiden tekoon. Jos käännät työsi itse, tarkistuta muilla ainakin sen oikeinkirjoitus. Periaatteessa huono kieliasu ei vaikuta arvosteluun, mutta käytännössä sellainen vaikeuttaa sanomasi perille menoa, joten kieliasun on hyvä olla kunnossa. Hyvä kieliasu luo vaikutelman, että olet muissakin toimissasi eli tässä kilpailutyössäsikin tarkka.

Mielestäni hyvä dokumentaatio käsittää neljä vaihetta: Varsinainen teksti, viitteet, kuvat ja lähteet. Nämä eriteltynä jo senkin tähden., että joskus kilpailuissa on rajoitettu dokumentaation pituutta (usein Drachenvaldissa 10 sivua ilman kuvia ja lähteitä), joten kuvat kannattaa liittää peräkkäin vasta tekstin jälkeen. Monimutkaisen työn selostamisessa kymmenen sivua täyttyy yllättävän nopeasti. Työ kun vielä kannattaa tulostaa isoa fonttikokoa käyttäen.

Mielestäni täydellisessä dokumentaatiossa on seuraavat kappaleet tai väli-otsikot pääosin tässä järjestyksessä:

1. työn esittely
2. miksi valitsin tämän aiheen eli tavoitteet työn alkaessa
3. pääasiallisesti käyttämiesi lähteitten esittely
4. materiaalien esittely ja vertailu autenttisiin materiaaleihin
5. käyttämiesi työtapojen esittely ja vertailu (ehkä myös työtavan tai työn historiasta)
6. varsinainen työn valmistaminen vaihe vaiheelta
7. isot ongelmat jotka tulivat vastaan ja niiden ratkaisut
8. kritiikkiä omaan työhöni sekä
9. loppukohtaus eli missä määrin tavoitteeni täyttyivät (ja mitä tekisin nyt toisin, jos...).

Ensimmäisenä päivänä kirjoita dokumentaatio. Tyhjennä aivosi, ja noudata suunnilleen ehdottamaani asiajärjestystä. Älä välitä kirjoitusvirheistä nyt. Älä juokse tarkistamassa viitteittesi teoksia tai niiden sivunumeroita, vaan jätä ne kohdat tyhjäksi tai kirjoita ulkomuistista. Kirjoita ylös ne lauseet, mitä mieleesi juolahtaa, voit aina siirtää ne oikealle paikalle tekstissäsi myöhemmin (edellyttäen, että kirjoitat tietokoneella). Kun pidät tauon, tarkista että olet kirjoittanut asiaa, joka lähenee artikkelin alussa olevaa muistamisen arvoista lausetta: Dokumentaation avulla perustelet ratkaisusi.... Kun olet kirjoittanut tekstisi kerran läpi, palaa asiaan vasta seuraavana päivänä. Lue romaani, katso leffa, nuku yön yli.

Seuraavana päivänä tulosta edellisen päivän teksti. Lue se huolella läpi. Etsi punakynä käsiisi. Korjaa kirjoitusvirheet. Vaihda lauseiden paikkaa ja kappaleiden järjestystä niin, että haluamasi asiat tulevat omiin kappaleisiinsa ja kappaleet pääosin yllä esitettyyn järjestykseen (työn esittely, tavoitteet....). Siten, että työsi etenee johdonmukaisesti eteenpäin. Kirjoita, mitä tuli yöllä mieleen ja täydennä kappaleet loogisiksi tai kirjoita kokonaan puuttuvat kappaleet. Printtaa juttusi taas ja ala vähitellen tarkistaa viitteitäsi. Tarkista läpi kirja kirjalta, että viitteet ovat oikein ja mielellään lisää sivunumerotkin (Tai sitten jätä johdonmukaisesti kaikista viitteistä pois sivunumerot). Nuku yön yli ja jatka varsinaisen tekstin kanssa seuraavana päivänä.

Lue taas tekstisi läpi ja... kas kummaa, vieläkin on korjattavaa. Vaihda joihinkin kohtiin paremmin ajatustasi kuvaava sana. Mieti, oletko selittänyt asioita tarpeeksi. Lisää unohtamasi asiat. Poista turhat, merkityksettömät sanat. Edelleen vaihda kappale- ja lausejärjestystä Tarkista, ettei tekstissäsi vilahtele liian vaikeasti ymmärrettäviä sanoja. Voit liittää ammattisanakirjan liitteeksi tekstin loppuun tai alaviitteeksi aina sanan kohdalle. Lisää sivunumerot. Tarkista että väliotsikoita on tarpeeksi ja jokainen uusi asia on omassa kappaleessaan. Mikään kappale ei saa olla liian pitkä; jaa ne sopivasta kohdasta. Kun juttu on mielestäsi helposti luettava ja ok, nuku taas yön yli.

Seuraavana päivänä.... arvaat varmaan. Vielä kerran.

Toista tätä niin kauan kuin on tarpeen. On tärkeätä, että iltaisin ajattelet muuta; muuten tulet sokeaksi omalle tekstillesi, ja se on vaarallista.

Lisää lauseista, viitteistä ja kappalejaoista

Käytä mahdollisimman lyhyitä ja selkeitä lauseita. Aloita kappale väitteellä ja jatka seuraavilla lauseilla sen perustelua. Muista lähdeviitteet. Voit myös koettaa kumota perusteluasi (Yhtäältä - toisaalta). Kappaleen loppuun, varsinkin jos perustelusi ovat pitkiä, voit tehdä lyhyen yhteenvedon perusteluistasi. Muista, että nopeasti lukien kappaleen ensimmäinen ja viimeinen lause ovat niitä, jotka jäävät lukijan mieleen parhaiten. Niiden sisällön on siis oltava kappaleen tärkeimmät!

Kaikki väitteet on perusteltava. Kaikki valitsemasi työtavat on perusteltava. Kaikki valitsemasi materiaalit on perusteltava. Kaikki lainattu tieto on osoitettava viitteellä. (Viite = tieto, kenen ja mistä kirjasta sekä miltä sivulta tieto on otettu). Lisää viite suluissa lauseen loppuun, alaviitteksi tai numeroviitteenä tekstin loppuun. Kritiikki on sallittua. On hyvä, jos kykenet suhtautumaan kritiiikillä omaan työhösi (siksi olen lisännyt omiin dokumentaatioihini sitä varten kokonaisen, oman kappaleen kirjoituksieni loppupuolelle).

Voit mainiosti kritisoida myös omia lähdeteoksiasi, jos siihen mielestäsi on aihetta. Minusta se sopii parhaiten tehdä dokumentaation alussa samassa kappaleessa, jossa esittelet ne. Se luo Sinusta omilla aivoillasi ajattelevan kuvan, joka ei sokeasti usko kaikkea mitä väitetään. Lähteiden laatu on tärkeätä: muista aina että on olemassa sekä huonoja että hyviä kirjoja, pidä huoli että pääasiassa käytät niitä hyviä.

Jos teet kilpailutyösi sekoitekankaasta kun alkuperäinen mallisi on ollut silkkiä, on ehdottomasti kerrottava miksi niin teet. Varattomuus on täysin hyväksyttävä syy. Pisteet sensijaan roimasti tipahtavat, jollet mainitse syytä.

Jos käytät työssäsi jonkun ystäväsi ideaa tai toistat hänen mielipiteensä, on kohteliasta antaa kunnia sille, kelle se kuuluu.

Kirjoita näin - älä näin

On hyvä antaa osaava vaikutus - älä nolaa itseäsi turhan takia edes antaaksesi kirjoitustyylillesi keveän tai vaatimattoman sävyn, sellaisen kiireiset tuomarit todennäköisesti ymmärtävät väärin. On hyvin tärkeätä, että ymmärrät tämän. Seuraavat esimerkit on poimittu omista dokumentaatioistani:
Ei näin: Värjasin valmiin kintaan krapilla ohjeen mukaan mutta hups, lopputuloksesta tulikin vihreä eikä punainen, kuten krapista pitäisi. Vaan: Värjäsin valmiin kintaan krapilla, mutta rautapadasta johtuneesta reaktiosta johtuen kintaasta tuli vihreä, vaikka krapilla värjätään nimenomaan punaista.
Ei näin: En osannut solmia alkusolmuja tarpeeksi tiukalle, ja siksi viitan putkihulpioreunasta tuli epätasainen. Vaan näin: Huomasin, että alkusolmujen täytyy putkihulpiota kudottaessa olla tavallista toimikasta huomattavasti kireämmällä, mutta silti kutominen oli vaikeata ja viitan reunasta tuli epätasainen.

Ulkoasu

Siisti ulkoasu on hyvin tärkeätä. Valitse tekstin fontti tarpeeksi selkeä (tässä tapauksessa kalligrafia ei ole hyvä vaihtoehto) ja kirjainkoko iso. Tuomareilla saattaa olla kiire, joten sanojen arvailuun ei jää paljoa aikaa. Tee työn dokumentaatiolle oma kansio tai laita ne omaan mappiin, jotteivat dokumentaation osaset katoa kesken matkan.

Valitse kuville taustakartonki, jolle ne liimaat (suosittelen sitä kallista sprayliimaa, jonka jäljiltä kuvien paikkaa voi vielä vaihtaa, joka ei tahraa ja ennenkaikkea joka ei jätä paperia kupruiseksi). Muista numeroida myös kuvasivut. Tee kuvista kuvaluettelo omalle sivulleen (vaikka kuviin on viitattu jo tekstissä) ja muista liittää siihen sivunumeroineen ne lähteet, joista kuvat on otettu.

Jos liität mukaan materiaalinäytteitä tai ulkonevia näytteitä työvaiheista, kiinnitä ne huolella, jotta ne varmasti pysyvät ja kansiosi kestää monen uteliaan selailut.

Viimeiseksi vielä omalle sivulleen lähteet. Ole huolellinen ja tarkista, että jokainen tekstissä tai kuvissa mainuttu lähdeteos, artikkeli tms. tulee mainituksi lähteissä. Jos lähteitä on paljon, otsikoi erikseen painetut ja painamattomat lähteet sekä sähköposti-tai suulliset tiedonannot sekä websivut, jos niitä olet käyttänyt.

Tähän viimeiselle sivulle jäljennä lähteittesi nimet huolella, jotta myös joku asiasta kiinnostunut ja samaa tietoa tarvitseva löytää Sinun löytämäsi tiedon äärelle. Huolehdi, että artikkelien osalta käy selkeästi ilmi, missä teoksessa ne ovat.

Hyviä dokumentaatioita toivottaa,

Mestari Tófa Jóhansdóttir