Pöytäkirja Sovellusprojekti Verso, 8. palaveri Paikka: kokoushuone Ag C226.2 Aika: maanantai 26.4.2010 klo 14:13-15:25 Pöytäkirja laadittu: 28.4.2010 Pöytäkirjaa muokattu: 3.5.2010 Läsnä Projektiryhmä Tero Hänninen, sihteeri Juho Nieminen, puheenjohtaja Marko Peltola Heikki Salo Tilaajan edustajat Ville Tirronen Ohjaajat Antti-Juhani Kaijanaho Jukka-Pekka Santanen 1 Kokouksen avaus Juho Nieminen avasi kokouksen klo 14:13. 2 Kokousvirkailijoiden valinta Puheenjohtajaksi valittiin Juho Nieminen ja sihteeriksi Tero Hänninen. 3 Laillisuus ja päätösvaltaisuus Kokous todettiin lailliseksi ja päätösvaltaiseksi. 4 Esityslistan hyväksyminen Esityslista hyväksyttiin sellaisenaan. 5 Edellisen palaverin pöytäkirjan tarkastaminen Edelliseen palaverin pöytäkirja oli tarkistettu ennen palaveria sähköpostitse. Edellisen palaverin päätökset käytiin läpi videoprojektorin avulla. PÄÄTÖS: - Edellisen palaverin pöytäkirja hyväksyttiin. 6 Edellisessä palaverissa sovitut tehtävät Ohjaajat - Santanen lähettää sähköpostia toisen väliesittelyn ja loppuesittelyn ajankohdasta (suoritettu). - Santanen koekäyttää sovellusta (kesken). Projektiryhmä - Suorittaa neljännen iteraation (suoritettu). - Salo tiedottaa 6. palaverin pöytäkirjan viimeisimmästä versiosta sähköpostitse (suoritettu). - Projektiryhmä pyytää THK:a avaamaan pääsyn YouSource-sovellukseen KOASin ja Kortexin verkoista, sekä VPN:n kautta (suoritettu). - Projektiryhmä pyytää pääsyä KorppiLDAPiin. Jos pääsyä ei saada, projektiryhmä pyytää pääsyä THK:n LDAPiin (suoritettu). - Lähettää sähköpostia Santaselle, kun koekäyttäminen sopii (suoritettu). - Lisätään tiketti: Git-tagien tiedot näkyviin sovelluksessa (suoritettu). - Lisätään tiketti: graafisten suunnittelijoiden aikataulun selvittäminen (suoritettu). - Lisätään tiketti: Jos sovelluksessa tietovarastolta puuttuu lisenssi, sen puuttumista korostetaan (suoritettu). - Kertoo tulevien esikäyttäjien kuulumisista Verson sähköpostilistalla (kesken). - Laatii sopimusluonnoksen jäsenten toteutettamien ohjelmaosioiden sijoittamisesta AGPL-lisenssin alle (kesken). 7 Tilakatsaus Projektipäällikkö Salo kertoi projektiryhmän suorittaneen neljännen iteraation ja että projektiin on käytetty 1360 tuntia. Yhteensä tunteja kertyy suunnitelman mukaan noin 1600. Salo ehdotti, että toinen koodinkatselmointi järjestettäisiin seuraavalla viikolla. Salo kertoi myös, että seuraavalla viikolla on tarkoitus tehdä pyyntöjä liittää projektiryhmän toteuttamia ominaisuuksia ja korjauksia alkuperäiseen Gitorious-sovellukseen. Tirronen huomautti, että korjaukset (patch) kannattaa laittaa päähaaran uusimman version päälle. Santanen kysyi, onko järjestelmää testattu kokonaisuutena. Salo vastasi, että ominaisuuksia on testattu aina kehittäessä ja sen jälkeen. Toisaalta kaikki uudet toiminnallisuudet on lisätty versotest-testipalvelimelle, jolloin myös kokonaisuus on tullut testatuksi. Varsinaista suunnitelmallista kokonaisuuden testausta ei ole suoritettu, mutta se on tarkoitus suorittaa seuraavalla viikolla. Santanen huomautti, että viimeistelyyn ja dokumenttien kirjoittamiseen menee yllättävän paljon aikaa. PÄÄTÖKSET: - Toinen lähdekoodin katselmointi suoritetaan tiistaina 4.5. klo 12. 8 Neljännen iteraation läpikäynti Salo kertoi iteraation sujuneen hyvin. Uusina ominaisuuksina iteraatiossa toteutettiin LDAP-autentikointi Korpin kautta, uusi ulkoasu, tietovarastokohtaisesti määritettävät lisenssit, tietovaraston alustaminen zip-tiedostolla sitä luodessa sekä yksittäisten tiedostojen lisääminen tietovarastoon WWW-käyttöliittymästä. LDAP-autentikointiin sekä oikeuksien ja näkyvyyksien toteuttamiseen kului suunniteltua enemmän aikaa, mutta muutoin tehtävät olivat suoraviivaisia. Nieminen esitteli sovelluksen uutta ulkoasua sekä mahdollisuutta alustaa tietovarasto ZIP-paketilla kun se luodaan. Tirrosen mielestä kenttä ZIP-tiedoston määrittämiseksi pitäisi sijoittaa ylemmäksi. Nieminen esitteli myös yksittäisten tiedostojen lisäämistä tietovarastoon. Hänninen kertoi, että jos yrittää lisätä täsmälleen saman tiedoston, joka on jo tietovarastossa, syntyy rikkinäinen commit. Historia tai mitään muutakaan tietoa ei tällöin kuitenkaan häviä. Nieminen toi esille, että YouSource vaatii ssh-avainta, ennen kuin sitä välttämättä tarvitsee. Hän esittikin, että sitä vaadittaisiin vasta sitten, kun sitä todella tarvitsee. Tällöin tietovarastoja olisi mahdollista päivittää ilman ssh-avaintakin, tosin vain WWW-käyttöliittymän kautta. PÄÄTÖKSET: - ZIP-tiedostokenttä nostetaan ylemmäksi lomakkeessa, jolla tietovarasto luodaan. - Lisätään tiketti: Yksittäisiä tiedostoja tietovarastoon lisätessä syntyy turha commit, jos tiedostot ovat täsmälleen samoja. - Lisätään tiketti: Vaaditaan ssh-avain vasta, kun sitä todella tarvitaan. 9 Viimeistelyssä toteutettavat asiat Salo kertoi, että viimeistelyssä kirjoitetaan valmiiksi projekti- ja sovellusraportti, sovelluksen asennusohje sekä dokumentti Korppi-LDAPin hyödyntämisestä autentikoinnissa. Lisenssisopimus luonnostellaan. Viimeistelyyn kuuluu myös lähdekoodin siistiminen, toinen lähdekoodin katselmointi sekä joidenkin sovellukseen toteutettujen ominaisuuksien ja korjausten tarjoaminen Gitorious-sovellukseen. Esikäyttäjien kanssa ollaan yhteydessä ja kuulumiset tuodaan myös projektiorganisaation tietoon. Viimeistelyvaiheessa suoritetaan myös sovelluksen suunnitelmallinen testaaminen. Laadittavien testitapausten mukaan kokeillaan, toimiiko sovellus oikein. 10 Esikäyttäjien kuulumisten läpikäynti Nieminen kertoi toisessa käytettävyystestauksessa käyttäjänä toimineella Tytti Saksalla olleen vain vähän kokemusta versiohallinnasta, lähinnä SubVersion-ohjelmasta. Gitin käyttö ei kuitenkaan tuottanut ongelmia YouSourcen tarjoamien ohjeiden ansiosta. Ssh-avaimen käyttö oli kuitenkin hankalaa. Ohjeita ssh-avaimen ja Gitin käyttöön on tämän jälkeen parannettu. Santanen ehdotti, että sovelluksen toimintojen kuvaamiseen tehtäisiin oma sivu. Tirronen kysyi projektiryhmän arviota siitä, kuinka suuri osa kokemattomista käyttäjistä saa ssh-avaimen tehtyä. Nieminen vastasi, että todennäköisesti noin puolet heistä. Santasen mielestä sovelluksen tulisi tarjota mahdollisuus väliversioiden ja julkaistavien versioiden tallentamiseen. Tirronen huomautti, että ideana on julkaista kokonaisia tietovarastoja (historioineen), ei vain tiettyjä versioita. Santanen huomautti, että sovellusraporttiin tulee kirjata versioiden julkistaminen jatkokehitysideana. Tirronen pohti, että tiettyjen versioiden julkaisemiseen ei ole sovelluksessa kovin mielekästä ratkaisua. Projektin wikiin on mahdollista lisätä linkkejä tiettyihin versioihin, joita ei kuitenkaan saisi linkistä suoraan ladattua tiedostopakettina. Sekä Tirronen että Kaijanaho olivat sitä mieltä, että tällä hetkellä sovelluksen käyttäjälle helpointa on sijoittaa tiedostopaketti jollekin sovelluksen ulkopuoliselle WWW-sivulle ja lisätä siihen linkki YouSourcessa. 11 Projektidokumenttien lisenssi Nieminen kysyi, onko tarpeen lisensoida projektissa laadittuja dokumentteja? Kaijanaho totesi, että sovellukseen liittyvät dokumentit olisi hyvä sijoittaa jonkin vapaan lisenssin alle, kuten jonkin Creative Commons -lisenssin alle. Lisenssin olisi suunnilleen vastattava AGPL-lisenssiä. Hän ehdotti, että dokumentit asetettaisiin CC-by-sa -lisenssin alle. PÄÄTÖKSET: - Sovellukseen liittyvät dokumentit asetetaan CC-by-sa -lisenssin alle. 12 Muut esille tulleet asiat Santanen pyysi palautetta Sovellusprojektit-kurssin kotisivulle kirjoittamastaan kuvauksesta Verso-projektista. Kaijanaho huomautti, että projektissa kehitetty sovellus on Git-keskeinen ja SVN-versiohallinnan käyttö sovelluksessa on toissijaista. Tirronen painotti, että loppuesittelyssä olisi hyvä tuoda esille, että sovellus tarjoaa yhteisen paikan lähdekoodeille ja edistää yhteistyötä. Nieminen korosti, että sovellukseen voi kirjautua Korppi-tunnuksilla, mikä alentaa kynnystä lähteä käyttämään sovellusta. Tirronen pohti, olisiko sovelluksesta mahdollista toteuttaa erikseen tutoriaali loppuesittelyn lisäksi. Hän totesi samalla, ettei tämä olisi välttämättä projektiryhmän tehtävä. Kaijanaho ehdotti, että jos projektiryhmälle kuitenkin sopii, se voisi tehdä noin viidentoista minuutin mittaisen esityksen. Salo huomautti, että projektin dokumentit ovat tällä hetkellä versotest-palvelimella. Dokumenttien URL-osoitteet vanhentuvat siis todennäköisesti pian projektin päätyttyä, kun testipalvelin suljetaan. Tämä ongelma voitaisiin kiertää uudelleenohjauksella. Dokumentteihin viitattaisiin kuin ne sijaitsisivat projektin WWW-sivustolla, mutta linkit ohjattaisiin YouSourcen-sivustolle. Kun YouSource-sivuston osoite muuttuu, tarvitsisi vain korjata uudelleenohjaus. Santanen kuitenkin ehdotti, että projektiryhmä lisää dokumentit projektin WWW-sivustolle. PÄÄTÖS: - Projektin dokumentit lisää projektin WWW-sivustolle. 13 Sovitaan seuraavan palaverin aika ja paikka Seuraava palaveri pidetään keskiviikkona 5.5.2010 klo 14:15 kokoushuoneessa Ag C226.2. 14 Osallistujien seuraavat tehtävät Ohjaajat - Santanen koekäyttää sovellusta. Projektiryhmä - Suorittaa viidennen iteraation. - Kertoo tulevien esikäyttäjien kuulumisista Verson sähköpostilistalla. - Laatii sopimusluonnoksen jäsenten toteuttamien ohjelmaosien asettamisesta AGPL-lisenssin alle. - Valmistelee toisen lähdekoodin katselmoinnin. - Lisää tiketin: Yksittäisiä tiedostoja tietovarastoon lisätessä syntyy turha commit, jos tiedostot ovat täsmälleen samoja. - Lisää tiketin: Vaaditaan ssh-avain vasta kun sitä todella tarvitaan. - Tarjoaa valikoiden kehitettyjä ominaisuuksia ja korjauksia Gitoriouksen kehittäjille. - Lisää projektin dokumentit projektin WWW-sivustolle. Toinen lähdekoodin katselmointi suoritetaan tiistaina 4.5. klo 12. 15 Kokouksen päättäminen Puheenjohtaja Juho Nieminen päätti kokouksen klo 15:25. 16 Jaettu ja käsitelty materiaali Palaverissa ei jaettu materiaalia. Puheenjohtaja ja projektipäällikkö esittelivät palaverin esityslistan ja tilakatsauksen videoprojektorin avulla.