skenaario
Dokumentaatio, joka ei vanhene sen mukana, miten asia on toteutettu
Kun osa järjestelmän toiminnallisuudesta voidaan toteuttaa agentilla yhtä hyvin kuin käyttöliittymällä tai rajapinnalla, perinteinen tekninen dokumentaatio vanhenee nopeammin kuin ehditään päivittää. CRD-spesifikaatio erottaa sen, mitä järjestelmä tekee, siitä, miten se on toteutettu.
Valto Loikkanen · CRD-spesifikaation kirjoittaja
Tekninen dokumentaatio kuvaa tyypillisesti tiettyä toteutusta: tätä näppäintä painetaan, tämä rajapinta kutsutaan näin. Kun agentti voi korvata tai täydentää minkä tahansa näistä toteutustavoista, tällainen dokumentaatio vanhenee nopeasti — ja pahimmillaan ohjaa agenttia jäljittelemään vanhentunutta prosessia sen sijaan, että se tavoittelisi haluttua lopputulosta suoraan.
CRD (Capability Requirements Document) on ehdotus siitä, että kyvykkyys — mitä järjestelmä tekee, kenelle ja millä ehdoilla — kuvataan erillään siitä, miten se on toteutettu. Spesifikaatio sisältää mallipohjan ja rakenteen sekä nimenomaiset ohjeet agenteille kuvausten tuottamiseksi olemassa olevista järjestelmistä keksimättä faktoja.
Tämä on tuoreimpia näistä neljästä hankkeesta ja muuttuu edelleen viikoittain (versio 0.3). Julkaisen sen silti nyt avoimena, koska ongelma, jota se yrittää ratkaista, tulee vain kasvamaan.