Blogi: Sanojen merkityksestä

30/09/2020

Vaatimusten määrittely on periaatteessa yksinkertainen tehtävä. Kuunnellaan, mitä asiakas haluaa ja kirjoitetaan vaatimukset sopivaan muotoon, niin että kehittäjät voivat ne toteuttaa. Tehtävä sisältää kuitenkin monia haasteita ja mahdollisia sudenkuoppia.

Kehitysmalleja on erilaisia ja vaatimukset voivat olla käyttäjätarinoita tai muodollisempia kuvauksia määrittelydokumentissa. Silti lähes poikeuksetta ne kuvataan sanallisesti, Suomessa yleensä suomeksi, ruotsiksi tai englanniksi.

Luonnollisen kielen haasteita

Kieli on viestintää kirjoittajalta lukijalle, ja on todennäköistä että kirjoittajan ja lukijan tiedoissa ja kokemuksissa on eroja. Tällöin tekstin ymmärtäminen voi olla vaikeata tai monimerkityksinen ilmaisu ymmärretään väärin. Esimerkiksi seuraavat asiat aiheuttavat usein haasteita vaatimusteksteissä:

  • Ammattislangi ja lyhenteet
  • Epäselvät sanat
  • Sekavat ja monimutkaiset lauserakenteet
  • Liiallinen tarinointi
  • Kielimuuri
 

Slangi ja lyhenteet

Omassa työporukassa on luontevaa käyttää ammattislangia ja lyhenteitä. Kuitenkin, jos halutaan tuottaa muille sidosryhmille ymmärrettävää tekstiä, slangi tulisi korvata selkeällä yleiskielellä. Usein esimerkiksi teknisten järjestelmien vaatimuksissa toki tarvitaan täsmällisiä ammattitermejä. Näistä voidaan tehdä erillinen sanasto, jossa niiden merkitys avataan sidosryhmille tarpeellisella tarkkuudella. Samalla varmistetaan, että yhdestä käsitteestä käytetään aina samaa termiä. Lyhenteet voidaan koota samaan sanastoon.

Epäselvät sanat

Adjektiivit ovat usein luonnostaan epätarkkoja, vailla selkeää mittaria tai vertailukohtaa. Vaatimusteksteissä näkee edelleen valitettavan usein epämääräisiä määreitä kuten "helppokäyttöinen", "standardinmukainen" tai "nopea vasteaika". Korusanat ovat käytännössä vailla merkitystä ellei niihin saada liitettyä todennettavia mittareita. Helppokäyttöisyyteen voi pureutua esimerkiksi määrittämällä tarvittavien hiiren klikkausten määrän jonkin tehtävän suorittamiselle.

Sekavat ja monimutkaiset lauserakenteet

Matematiikassa loogisissa lauseissa eri operattoreilla on määrätyt ensisijaisuudet (EI, JA, TAI) ja lauseita voidaan tarvittaessa myös selventää sulkumerkeillä. Luonnollisessa kielessä näitä keinoja ei ole, vaan lauserakenne on muotoiltava niin että väärinymmärrys ei ole mahdollinen.

Esimerkiksi seuraava lause: "Bonuskorttia käyttävät tai alennuskoodi-asiakkaat ja yli 100 eurolla tilaavat saavat ilmaisen toimituksen" voidaan tulkita kahdella eri tavalla:

  1. bonuskortti TAI (alennuskoodi JA yli 100 €)
  2. (bonuskortti TAI alennuskoodi) JA yli 100 €)

Monimutkaisia ehtoja sisältävät pitkät lauseet kannattaakin yleensä purkaa erillisiksi lauseiksi taikka taulukoiksi. Jos tarkoitettiin tulkintaa 1, voidaan muotoilla esimerkiksi: "Bonuskorttia käyttävät saavat aina ilmaisen toimituksen. Lisäksi ilmainen toimitus annetaan, jos käytössä on alennuskoodi ja tilaus on arvoltaan yli 100 euroa."

Liiallinen tarinointi

Monet puhujat pitävät puhumisesta ja jatkavat tarinaansa erilaisilla täytesanoilla ja poikkeavat asiasta sivuraiteille. Samoin sitten käy helposti kirjoitettaessa.
Vaatimuksia kirjoitettaessa kannattaa sensijaan harkita tarkkaan jokaisen sanan merkitys ja miettiä lauseista onko se tarpeellinen asian ymmärtämisen kannalta vai turhaa täytettä. Asioiden kertaaminen on ehdottoman turhaa. Tulee muistaa, että turhaan pidennetty teksti hidastaa lukemista ja tekee mahdollisista muutoksista aina vaikeampia.

Toki liian niukkakaan ei saa olla, vaan tekstissä tulee olla kaikki tarpeellinen muttei mitään ylimääräistä.

Kielimuuri

Englannin kieltä käytetään Suomessa ja muissa ei-englanninkielisissä maissa paljon työkielenä. Monet kieltä osaavat (yli 75%) eivät kuitenkaan puhu sitä äidinkielenään. Vaikka kieli on yleinen, se ei ole erityisen helppo, muun muassa sanaston rikkauden johdosta. Tästä seuraa paljon potentiaalisia ymmärtämisen ongelmia.
Mitä siis neuvoksi? Yllä olevat keinot auttavat paljon tässäkin. Kannattaa ehkä harkita onko aina pakko käyttää englantia vai voisiko täysin kotimaassa tehtävän projektin määritellä suomeksi.

Kokemuksen ja koulutuksen kautta opimme paremmiksi vieraan kielen käyttäjiksi. Jos teksti on tärkeä, kannattaa se aina tarkastuttaa toisella lukijalla. Myös ammattiapua on tarjolla. ImproveIt:n tytäryhtiö WriteIt tarjoaa englannin kielentarkastusta vankalla kokemuksella. Siitä voit lukea lisää täältä.