Harjoitustyön (suositus) Aikataulu

Kurssilla on palautus jokaisen viikon lauantaina, näiden deadlinet löytyvät kurssikalenterista moodlesta.

Viikko 1

• Aihe, käytettävä ohjelmointikieli ja työn laajuus päätetty.
  • Tutustu aihe-ehdotuksiin.
  • Juttele tarvittaessa ohjaajan kanssa, varsinkin jos sunnittelemasi aihe ei ole ehdotusten listalla.
  • Ohjaaja tarkistaa määritelydokumentin ja antaa palautetta tarvittaessa.
• Harjoitustyön repositorio alustettu ja rekisteröity Labtooliin.
  • Muista myös sallia issuet.
• Projektinhallinta kunnossa.
  • Tämä tarkoittaa, että repositorion pitäisi olla tehtynä ja labtooliin rekisteröitynä. Tämän lisäksi jonkinlainen tapa kääntää koodia ja hallita riippuvuuksia pitäisi olla. Pythonilla tämä voi tarkoittaa poetrya, mutta jos jokin muu työkalu on tutumpi niin sitäkin saa käyttää.

Viikko 1. Palautus (katso päivä kurssikalenterista ja ohjeet palautuksista)

• Viikkoraportti 1
• Määrittelydokumetti
  • Tärkeää Muista kirjoittaa määrittelydokumenttiin opinto-ohjelmasi ja projektin kieli!
  • Muista kirjoittaa määrittelydokumenttiin myös mikä on harjoitustyösi ydin, lisää ohjeita määrittelydokumetin ohjeissa.

Viikko 2

• Projektin ydinalueen kehitykseen pitäisi päästä jo tällä viikolla.
  • Tämä tarkoittaa esimerkiksi, että jos teet pelin tekoälyä, itse tekoälyn kehitykseen pitäisi (mielellään) päästä jo tällä viikolla.
  • Jos harjoitustyöösi kuuluu tietorakenteiden toteutusta, voit tässä vaiheessa käyttää kielesi valmiita rakenteita ja korvata ne myöhemmin.
• Projektin koodi on alusta asti dokumentoitua
• Projektin testien (ja yksikkötestien) kehitys edustavilla syötteillä aloitettu.
  • Kehitä testejä samaan aikaan koodin kanssa.
  • Testien on tarkoitus mitata koodin oikeellisuutta. Älä kuluta aikaa tarpeettomien testien kehitykseen, vaan mieti ensin minkälaisia testejä juuri oma työsi tarvitsee.
    • Testaus sivuilla on materiaalia, mutta kaikki harjoitustyöt eivät tarvitse kaikkea sieltä löytyvää.
  • Projektin testikattavuus seurattavissa.

Viikko 2. Palautus

• Viikkoraportti 2

Viikko 3

• Projektin ydinalue kehittynyt
  • Projektilla on toimiva (ei tarvitse olla hiottu) käyttöliittymä.
  • Ydintoimintaa tukevat metodit kaikki valmiita.
  • Ideaalitapauksessa viikon aikana työtä pitäisi jo voida ajaa ja sen toiminnallisuutta havainnoida.
• Koodin laatua ylläpidetään esim pylintin avulla.
• Projektin jo toteutetut päämetodit ovat kattavasti yksikkötestattuja edustavilla syötteillä.
• Testausdokumentin kirjoitus aloitettu.
  • Dokumentissa testikattavuuden raportti

Viikko 3. Palautus

• Viikkoraportti 3

Viikko 4

Tällä viikolla kannattaa keskittyä harjoitustyön valmisteluun vertaisarviointia varten. Varmista, että koodisi on sellaisessa kunnossa, että siitä voi antaa merkityksellistä palautetta.

• Ohjelman ydintoiminta melkein valmis. Mahdolliset omat tietorakenteet aloitettu.
• Koodi hyvin dokumentoitua ja kattavasti testattua.
• Toteutusdokumentin teko aloitettu.
• Mahdollisten yksikkötestejä täydentävien testien kehitys aloitettu.
  • Muista, että kaikkia mahdollisia eri testityyppejä ei tarvita. Mieti mitkä ovat oleellisia oman aiheesi oikeellisuuden testaamiseen.
  • Kirjoita näistä testausdokumenttiin.

Viikko 4. Palautus

• Viikkoraportti 4
• Ensimmäinen vertaisarviointi jaetaan viikon palautuksen jälkeen.
  • Katso labtoolista linkki katselmoitavaan repoon.
  • Muista sallia issuet
  • Vertaisarvioinnin deadline on kolme päivää arvioiden jaon jälkeen.
  • Ohjeet vertaisarviointiin moodlessa.

Viikko 5

• Ensimmäinen vertaisarviointi tehty.
• Oman harjoitustyön saaman palautteen hyödyntäminen
• Toteutus- ja testausdokumentti ajan tasalla.
• Ohjelman ydintoiminta valmis. Mahdolliset omat tietorakenteet melkein valmiina.
• Ohjelman testit kattavia.

Viikko 5. Palautus

• Viikkoraportti 5

Viikko 6:

• Toinen vertaisarviointi.
• Ohjelman viimeistelyä.
• Testien viimeistelyä.
• Dokumentaation viimestelyä.
  • Muista käyttöohje

Viikko 6. Palautus

• Viikkoraportti 6
• Toinen vertaisarviointi jaetaan viikon palautuksen jälkeen, tälle deadline muutama päivä arvioinnin jälkeen.
  • Katso labtoolista linkki katselmoitavaan repoon.
  • Muista sallia issuet
  • Vertaisarvioinnin deadline on kolme päivää arvioiden jaon jälkeen.
  • Ohjeet vertaisarviointiin moodlessa.

Lopullinen Palautus

(Tarkka päivä löytyy moodlen kalenterista)

Dokumentaatio:

• 100% selkeä ja kommentoitu koodi
• Valmiit dokumentit:
  • Määrittelydokumetti (ei tarvitse päivittää alkuperäisestä)
  • Toteutusdokumentti
  • Testausdokumentti
  • Viikkoraportit
  • Käyttöohje

Ohjelma:

• Mielellään suoritettava ohjelma.
• Toiminallisuudessa määrittelydokumenttiin kirjoitettu laajuus saavutettu.
• Työ valmis ja hiottu.

Testaus:

• Koodin kattava yksikkötestaus
• Ohjelman testaus dokumnetoitu testausdokumenttiin

Korjauksia tälle sivulle

Tee korjausehdotus editoimalla tätä tiedostoa GitHubissa.