Esimerkkikoodi

Esimerkkikoodi tarkoittaa ohjelmointikielellä kirjoitettua koodia, jota käytetään havainnollistamaan ohjelmoinnin käsitteitä, algoritmeja tai API:en käyttöä dokumentaatiossa ja opetuksessa. Sen päämäärä on näyttää käytännön toimintaperiaatteita ja antaa lukijalle mahdollisuus tutustua koodin toteutukseen ilman erillistä kokeilua.

Tyypillisesti esimerkkikoodi on pienialainen, itsenäinen ja mahdollisimman vähän riippuvainen suuremmasta projektista. Sen tulisi olla selkeä ja helposti suoritettavissa, esimerkiksi käyttämällä vakioarvoja tai simulointitilanteita. Dokumentaatiossa esimerkkikoodi esitetään usein koodilohkoina tai inline-koodina sekä lyhyin selityksin.

Hyvät käytännöt huomioivat muun muassa kuvaavat muuttujien ja funktioiden nimiä, asianmukaiset kommentit sekä konkreettiset, todennettavissa olevat esimerkit. Koodin tulokset tai odotettu käyttäytyminen tulisi osoittaa selvästi. On tärkeää välttää API-avainten ja muiden arkaluontoisten tietojen tallentamista esimerkkikoodiin, ja käyttää tilapäisarvoja tai varoitusmerkintöjä. Lisäksi esimerkkikoodi tulisi vastata nykyistä ohjelmisto- tai kirjastoversiota, ja tarjota viitteet alkuperäiseen dokumentaatioon lisätietoja varten.