9. palaverin pöytäkirja

Paikka: AgC226.1 (Agora, Mattilanniemi 2, Jyväskylä)
Aika: tiistai 9.5.2017 klo 9:06-12:15

Pöytäkirja

Laadittu 9.5.2017
Muokattu 17.5.2017

1 Kokouksen avaus

Topi Latva-Salo ehdotti itseään puheenjohtajaksi ja Tuomas Porvalia sihteeriksi. Ehdotukset hyväksyttiin.

2 Laillisuus ja päätösvaltaisuus

Palaveri todettiin lailliseksi ja päätösvaltaiseksi ensimmäisessä palaverissa sovittujen käytäntöjen perusteella.

3 Esityslistan hyväksyminen

Esityslista hyväksyttiin.

4 Edellisen kokouksen pöytäkirjan hyväksyminen

Edellisen pöytäkirjan päätökset käytiin läpi. Pöytäkirjasta korjattiin 6. kohdassa käytetty termi "Rhoo-reitti" oikeaan muotoon raw-reitti.

Projektiryhmälle sovittujen toimenpiteiden tilat todettiin seuraaviksi:

• Tutkivat usean tyylin muokkautumisen TeX-käännöksessä (kesken).
• Tarkentaa projektin vaatimuksia (kesken).
• Lisää työkulkukaavioon virhetilanteet (kesken).
• Testaa LaTeXin pysähtymistä virheen takia (suoritettu).
• Lisää Trelloon vaatimuksen: CSS-tulostuksessa taulukon viivat ja värit (suoritettu).
• Täsmentää vaatimusta: Toiselle kielelle käännetyn dokumentin tulostaminen (kesken).
• Vie kaikki ohjelmointityöt tietovarastoon koodikatselmointia varten 13.4 mennessä (suoritettu).
• Päivittävät työnkulkukaavion ajan tasalle (kesken).
• Tulostavat projektisuunnitelman (suoritettu).
• Projektipäällikkö kerää projektisuunnitelmaan allekirjoitukset (suoritettu).
• Täsmentävät TIMiin sijoitettavaa LaTeX-pohjatiedostoa (suoritettu).
• Selvittävät kansilehden selkämyksen muodon (suoritettu).

Tekniselle ohjaajalle sovittujen toimenpiteiden tilat todettiin seuraaviksi:

• Korjaa etäkoneen oikeudet (suoritettu).
• Tarkistaa onko TIMissä funktio, joka antaa kappaleen sisällön muodossa, jossa makrot on ajettu (suoritettu).

Päätökset:

• Pöytäkirjan 5. ja 6. kohtien viimeiset päätökset vaativat tarkennusta.
• Pöytäkirja hyväksyttiin korjauksin.

5 Tilakatsauksen läpikäynti

Tilakatsauksessa käytiin läpi tehtyjä töitä ja tulevia töitä. Myös vaatimuksia käytiin läpi ja korjattiin. TeX-tulostuksessa taulukon viivat siirrettiin jatkokehitykseen. Marja totesi, että käyttöliittymän vaatimukset eivät enää ole nyt suunniteltua käyttöliittymää kuvaavia, joten ne kirjoitetaan uudelleen. Tulostusasetuksen vaatimukset määritellään uusiksi ja uudet määritykset tehdään templatetiedoston pohjalta.

Käydyistä vaatimuksista muutettiin prioriteetteja ja tiloja.

Tilakatsauksen aikana myös testattiin koodin syntaksi korostusta haskellilla, joka ei toiminut. Vesa ehdotti, että projektiryhmä tekee käsin LaTeX-dokumentin, joka sisältää apumuuttujia debuggauksen helpottamiseksi. Vesa pyysi myös, että ryhmä testaa hidden-print makroa sisällölle, joka ei saisi näkyä tulostuksessa.

CSS-tulostuksessa Vesa kysyi, onko mahdollista ylikirjoittaa bootstrapin CSS-asetuksia, johon Tuomas vastasi, että ei ole ja hän on jo yrittänyt aikaisemmin. Tähän Vesa ehdotti, että testataan mitä CSS-tulostuksessa muuttuu, jos bootstrapin tulostusasetuksia ei käytetä olenkaan.

Päätökset:

• Käyttöliittymän vaatimukset kirjoitetaan kokonaan uudestaan.
• Tulostusasetuksen vaatimukset määritellään templatetiedoston pohjalta.
• Taulukon viivat siirretään jatkokehitykseen.
• Tutkivat hidden-print makroa sisällössä, joka näkyy vain tulostamisessa.
• Lisäävät vaatimus tilan, joka kuvaa: ominaisuus on tehty, mutta ei ole testattu.
• Projektiryhmä testaa miten html-taulu tulostuu LaTeX:illa.
• CSS-tulostuksessa testaavat mitä tulostuu ilman bootstrapin CSS-print asetuksia.

6 Tulostuksen templatet TIMissä

Käytiin ryhmän tekemä template pohja läpi. Marjalla oli ollut ongelmia TIM-dokumentin laajentamien/piilota ominaisuuden kanssa. Mika selvensi, että ongelma tapahtui, koska TIM-dokumentin asetukset eivät olleet aivan TIM-dokumentin alussa.

Käyttöliittymästä Topi kertoi, että TIMissä on valmiina default template, mutta käyttäjä voi halutessaan valita custom templaten. Jukka-Pekka antoi esimerkin, että voi olla olemassa template opiskelijalle ja ohjaajalle, ja näitä templateita käytetään samassa TIM-dokumentissa. Vesa täydensi, että käyttöliittymässä on radio button, jonka valitsemalla ilmestyy tekstilaatikko ja johon käyttäjä voi kirjoittaa templaten nimen, esimerkisi aiemmin mainitun templaten ohjaajille, jolloin käyttöliittymä etsii TIMin hakemistorakenteesta kyseistä templatea.

Vesa ehdotti, että dokumentin sisältö, mikä ei saisi näkyisi tulosteessa, voisi ajaa makron läpi, joka kommentoi sisällön, jolloin se on rajattu pois tulostettavasta dokumentista tai makro ei tee mitään, eli sisältöä ei käsitellä, mutta ei myöskään tule tulosteeseen.

Jukka-Pekka kysyi dokumentin versionumeroinnista. Tähän vastattiin, että versionumeroinnissa käyttäjä voi asettaa versionumeron käsin tai se on oletuksena automaattisesti määritelty.

Päätökset:

• Tulostustemplate haetaan hakukentän avulla. Muutoin käytetään valmista default templatea tai käyttäjä voi muokata oman tulostustemplaten.
• Sovittiin jatkokehitysideaksi, että tulostustemplate koostetaan useista TIM-hakemistorakenteista löytyvillä templateilla.

7 CSS-asetukset

CSS-tulostuksessa Tuomas kysyi, että miten asetukset tullaan esittämään Customize Tim -sivulla. Vesa kertoi, että kaikki tulostukseen liittyvät asetukset tulevat CSS:än media print asetuslohkon sisälle. Jos käyttäjä haluaa vaikuttaa TIM-dokumentin ulkoasuun, on hänen tehtävä tarvittavat CSS-koodit itse. Vesa myös kertoi, että tulostusasetuksissa voidaan hyödyntää myös TIM:in teema asetuksia joillekin asetuksille. Esimerkiksi kommenteille voi tehdä valintaruudun.

Päätökset:

• Vain tulostukseen vaikuttavat asetukset Customize Timin tekstikenttään. Ei koske muita asetuksia TIM-dokumentissa.

8 Muut esille tulevat asiat

Miika oli kysynyt, että onko mahdollista hyödyntää käyttöliittymäkirjastoja. Mika totesi, että niiden käyttäminen menee projektin ulkopuolelle, joten projektiryhmä tulee hyödyntämään mitä kirjastoja on jo TIMissä.

TIMin asetuslehdelle etsitiin ikonia ja alustavasti sille ehdottetiin jakoavainta. Vesa esitti, että asetuslehden nimeksi vaihdettaisiin Tools ja TIM-dokumentin manage-sivu siirretään tools välilehdelle.

Jukka-Pekka kysyi testauksen toteuttamisesta. Hän ehdotti, että testaus suoritetaan määritelemällä testausdokumentit ja testikohtaisesti määritellään testitapaukset, jotka koostetaan dokumenttikohtaisesti. Tähän ei tehdä testaussuunitelmaa. Vesa puolestaan ehdotti automaattitestausta, jossa lähtötiedostosta tulee aina saman näköinen. Kohdetiedostoa verrataan refernssitiedostoon, joilloin varmistetaan tiedostojen samankaltaisuus. Refernssitiedostoon sijoitetaan haastavia osia, esimerkkiksi taulukot.

CSS-testausksen toteuttaminen jäi avoimeksi.

Jukka-Pekka kysyi toiselle koodikatselmoinnille aikaa. Asia päätettiin siirtää seuraavaan palaveriin tai jos ryhmä löytää sopivan ajan kohdan ennen sitä.

Päätökset:

• Viimeistään seuraavassa palaverissa sovitaan päivämäärä toiselle koodikatselmoinille.
• Projektiryhmä ei hyödynnä ylimääräisiä TIMiin sisältymättömiä käyttöliittymäkirjastoja.
• Projektiryhmä miettii testautuksen toteuttamista.

9 Läsnäolijoille sovitut toimenpiteet

Projektiryhmälle sovittiin tehtäväksi seuraavat toimenpiteet:

• Tutkivat usean tyylin muokkautumisen TeX-käännöksessä.
• Tarkentaa projektin vaatimuksia.
• Lisää työkulkukaavioon virhetilanteet.
• Täsmentää vaatimusta: Toiselle kielelle käännetyn dokumentin tulostaminen.
• Päivittävät työnkulkukaavion ajan tasalle.
• kirjoitetavat käyttöliittymän vaatimukset kokonaan uudestaan.
• Tutkivat hidden-print makroa sisällössä, joka näkyy vain tulostamisessa.
• Lisäävät vaatimus tilan, joka kuvaa: ominaisuus on tehty, mutta ei ole testattu.
• Projektiryhmä testaa miten html-taulu tulostuu LaTeX:illa.
• CSS-tulostuksessa testaavat mitä tulostuu ilman bootstrapin CSS-print asetuksia.

10 Seuraavan palaverin aika ja paikka

Seuraava palaveri pidetään 18.5. klo 16:15 huoneessa AgC226.1

11 Kokouksen päättäminen

Puheenjohtaja päätti palaverin kello 12:15.

12 Jaetut ja käsitellyt materiaalit

• Tilakatsaus