Dokumentaatio
Madiskonin dokumentaatio kuvaa sekä ajatuksen että toteutuksen. Julkaistavat versiot pidetään luettavina verkossa ja teknisen kehityksen muutokset ja aiemmat versiot säilytetään järjestelmällisesti (versionhallinta).
White Paper
Madiskonin taustaa ja tavoitteita esittelevä asiakirja (White Paper) kuvaa arvot, rajaukset ja perustelut. Madiskon White Paper v2.0 (PDF) →
Toiminnallinen määrittely
Käytännön käyttötilanteet (käyttötapaukset), ohjelmistolta odotettu toiminta (toiminnalliset vaatimukset), hakutoiminnot sekä aineistosta julkaisuun -prosessi.
Arkkitehtuuri ja vaatimusmäärittely
Madiskonin osien rakenne ja niiden yhteistyö (arkkitehtuuri) sekä toteutukselle asetettavat vaatimukset (vaatimusmäärittely). Dokumentti käsittelee toimijan omaa Madiskon-ympäristöä (Studio-instanssi), eri toimijoilla säilyviä aineistoja ja palveluja (hajautettu toimintamalli), yhteisiä hakutietoja kokoavia palveluja (indeksi-instanssit), teknisiä liitäntöjä muihin palveluihin (integraatiot) ja teknisiä vaihtoehtoja. Tavoitearkkitehtuuri ja vaatimusmäärittely v2.1 (PDF) →
Tietomalli
Tapa kuvata esimerkiksi henkilöitä, paikkoja, tapahtumia, aineistoja ja niiden suhteita (tietomalli). Tietomalli erottaa tapahtuman, sitä esittävän aineiston ja dokumentoinnin ajankohdat (aikatasot) sekä kuvaa tiedon alkuperää ja käsittelyhistoriaa (provenienssi), kieliversioita ja yhteyksiä muissa palveluissa käytettyihin kohteen yksilöiviin merkkeihin tai verkko-osoitteisiin (tunnisteet).
Kehityshistoria
Päätökset, luonnokset, versiot ja toteutusta koskevat muistiinpanot. GitHub toimii Madiskonin teknisenä kotina, kun julkinen ohjelmakoodin ja kehityshistorian säilytyspaikka (repository) avataan.