Kokouspöytäkirja                6.5.2002

Ohjelmistotuotantoprojektiryhmä 1. Tapahtumapohjaisten järjestelmien 
jonomallien visualisointi
Kevät 2002


KOODIKATSELMUSKOKOUS

Aika		Torstai 2.5.2002 klo 16.15. - 17.10
Paikka		Helsingin yliopisto, TKTL
		Teollisuuskatu 25-27, B436

Paikalla        Lauri Aarnio, puheenjohtaja
		Kimmo Airamaa
		Esko Kupiainen
		Liisa Länkä, sihteeri
		Janne Petäjä
		Heikki Tuominen
		Johannes Ukkonen

Kokouksessa käytiin kokonaan läpi ohjelman englanninkielinen käyttöohje. 
Projektiryhmä oli tutustunut käyttöohjeeseen etukäteen. 

1. Kokouksen avaus

Puheenjohtaja avasi kokouksen klo 16.15. Liisa Länkä valittiin sihteeriksi.

2. Otsikko

Katselmuksessa tuli esille seuraavia muutos- ja parannusehdotuksia:
- Otsikko-osasta puuttuu päiväys. 
- Versionumeroksi päätettiin antaa 1.0 eikä 0.6.
- Todettiin, että kuvia voisi olla enemmän.

3. Sisällysluettelo

- Luku 3 kannattaa muuttaa luvuksi 3.1 ja luku 4 Running TAVI luvuksi 3.

4. Käyttöohjetekstin läpikäynti

4.1. Luku 1 General

- Otsikko General muutetaan otsikoksi Introduction/Overview
- Lisätään maininta, että kyseessä on Ohtu-projekti ja että kyseessä 
  ei ole vielä valmis tuote, vaan tulevat projektit jatkavat työtä.
- Lisätään linkki projektin kotisivulle.
- Sana picture korvataan sanalla figure koko asiakirjassa.
- Poistetaan yksityiskohtaiset sovellusta koskevat tiedot.
- Tehtiin pieniä muutoksia lauserakenteeseen ja sanavalintaan.
- Kuvatekstiksi: Figure 1: An example of Transaction flows between serers.

4.2. Luku 2 Installation 

- Muutetaan lauserakennetta: You can get korvataan passiivilla.
- Poistetaan simply-sanat koko asiakirjasta.
- Poistetaan www-osoitteen kirjoittamista koskeva lause.
- Sana issue korvataan sanalla enter.
- Lauserakenteisiin thedään pikku muutoksia.

4.3. Luku 3 Starting and Quitting TAVI

- Muutetaan paikka luvun Running TAVI alaluvuksi > 3.1.
- Päätason otsikossa kaikki sanat pitää olla isoilla alkukirjaimilla.
- Jätetään pois sivulause: which you created on the previous step.

4.4. Luku 4 Running TAVI

- Sana draw area korvataan sanalla drawing area koko asiakirjassa.
- Tehdään joitain pieniä täsmennyksiä kieliasuun.
- Menuja koskevissa kappaleissa  menuvalinta erotetaan muusta lauseesta 
  -merkillä tai kaksoispisteellä.
- Be careful... korvataan: Please, be careful...
- Transaktiohin liittyen hieman lisätekstiä: Transaktion ovat palvelupyyntöjä 
  servereiden välillä.
- Transaktiomenuista lisätään kuvia.
- Current -kohtaan täsmennys, että menussa on alamenu, jossa aktiivisen 
  transaktion voi vaihtaa.
- Käyttöohjeessa on sekaisin termejä, joissa tekstiä pitäisi yhdenmukaistaa: 
    - TAVI-graph ja TAVI graph
    - control point ja selection area
    - server, service point ja cell
    - transaction flow, flow ja edge.
- Luvuissa 4.2. ja 4.3. poistetaan viimeiset pisteet otsikoista.
- Kappaleessa Toolbar sana edge korvataan sanalla side.
- Poistetaan tietorakenteita koskeva teksti luvusta 4.3.
- Chapter korvataan sanalla section, kun kyseessä on aliluku.
- Transaktiokäsittelyyn lisätään täsmennys, että oletustransaktion id = Tr0.
- Muuttujien nimeä ei voi muuttaa: korjataan ohjetta. Samalla lisätään 
  täsmennys, ettei kahta samannimistä muuttujaa saa olla.
- Sanat can't korvatan: cannot.
- Rekursiivisia kaaria voi olla 0..10, eikä enää enintään viisi. Korjataan 
  ohjetta.
- By hand korvataan: manually.
- Ohjeessa on sanottu kahdesti, ettei kaari saa törmätä serveriin. Poistetaan
  näistä jälkimmäinen
- Peru-näppäimeen täsmennys: käsin reititettäessä rmb poistaa reititetyn
  kaaren, muttei source server -valintaa.
- Objektin ominaisuuksien muuttamisesta kuva.
- Sana bigger korvataan greater.
- Lisätään serverin sijainnin muuttamista koskeva kohta.
- Clicking delete-button korvataan: pressing delete key.

5. Kokouksen päättäminen

Puheenjohtaja päätti kokouksen klo 17.10.



Pöytäkirjan vakuudeksi



Liisa Länkä