Komponentti/järjestelmä spesifikaation (SoftaSpec) täyttöohjeita:
=====================================================

- Luvut täytetään pääsääntöisesti järjestyksessä: 1, 4, 5, 6, 7, 8, 9, 10, 11 ja 12

- Luku 1 = kattaa projektin tiedot, Luku 4 kattaa määrittelyn, 
  luvut 5, 6, 7, 8 (sekä 9) ovat toteutusta edeltävää suunnittelua HUSA:n mukaisessa
  järjestyksessä (luku 9 ei sisälly varsinaisesti HUSA-analyysiin) ja luvut 10, 11 ja 12 
  toteutuksen jälkeen/sen yhteydessä täytettävää dokumentaatiota

- Luvut 2 ja 3 on tarkoitettu dokumentin lukijan avuksi ja niitä täydennetään 
  tarvittaessa koko dokumentin täyttämisen ajan

- Myös lukua 4 joudutaan yleensä muuttamaan/täydentämään lukujen 7 ja/tai 8 valmistuttua

- Kaikkia lukuja ei välttämättä tarvitse täyttää loppuun asti vaan seuraavaan lukuun
  voidaan siirtyä kunhan ko. vaiheeseen osallistuvilla on riittävä perusta ko.
  vaiheen aloittamiseen

- Lukuja 4, 5, 6, 7, 8 ja 9 sekä vastaavasti 10, 11 ja 12 voidaan täyttää rinnakkain
  edellämainituilla edellytyksillä.


- Kaikki luvut eivät ole pakollisia kaikentyyppisille ohjelmistoprojekteille
  vaan esim. yksinkertainen komponenttikuvaus dokumentti saattaa koostua pelkästään
  luvuista: 1,2,3 ja 7. Järkeä saa tässä suhteessa käyttää. Ainakin luvut 6 ja 9
  jätetään monesti pois. Lukujen pakollisuudesta eri tyyppisissä projekteissa on 
  informaatiota luvun alussa ja laatujärjestelmän yleiskuvauksessa (STEP)




- STEP laatujärjestelmän yhteydessä kehittämäni HUSA analyysi helpottaa tietojärjestelmän
  määrittelyä/suunnittelua ja auttaa etenemään prosessissa tarkoituksenmukaisesti.
  HUSA:aan voi tarkemmin tutustua erillisessä dokementissa (HUSA.txt)

- Parasta olisi jos dokumentin datasisältö voitaisiin eristää tästä dokumenttipohjasta
  / pohjista esim tietokantaan tai xml-tiedostoihin. Tätä silmällä pitäen olen 
  kehittämässä järjestelmää jonka kautta voitaisiin syöttää esim. vaatimukset
  ja rajapintakuvaukset xml-formaattiin josta ne sitten erityisen dokumenttitemplaatti
  kielen perusteella täydennettäisiin varsinaisiin dokumentteihin.  
  Dokumentteihin tullaankin jatkossa lisäämään erityisiä html-kommenttien 
  sisään upotetuja datatageja. XSL:n käyttöäkään ei ole tulevaisuudessa suljettu
  pois mutta tällä hetkellä sen tarjoama turhan mutkikas ja dataläheinen rajapinta
  yhdistettynä pohjana käytettävän sivun rajoituksiin eivät vielä ole riittävän 
  pitkällä STEP:n mukaisia tarpeita varten.

- Komponentti/järjestelmä spesifikaation lisäksi jokaisesta projektista
  tulisi olla projektisuunnitelma ja ohjelmistoprojektista koodit.
  projektisuunnitelma pohja on linkitettynä Komponentti/järjestelmä spesifikaatioon.

- Tässä mahdollisesti esiintyvät tuntemattomat termit on listattu itse dokumentissa
  tai laatujärjestelmäkuvauksessa.


Tämä dokumentti on vapaasti kaikkien käytettävissä mutta tekijä
ei ota mitään vastuuta tai kantaa sen soveltuvuudesta ulkopuoliseen käyttöön.

Luvialla,
14.3.2003
Juha Lähteenmäki

- Kaikkein pienempiä projekteja varten on nyt myös käytössä pelkistetympi projektikortti joka on   projektisuunnitelman ja projektin kohteen kuvauksen yhdistelmä. Projektikortti sopii
  ohjelmistoprojektien lisäksi käytettäväksi myös muun tyyppisissä projekteissa esim. tutkielmat.

9:35 17.6.2003
JUha Lähteenmäki

Päivitetty SoftaSpec nimi

16:22 20.7.2003
Juha Lähteenmäki