Raportin kirjoittaminen

Table of Contents

Raportin kirjoittaminen

Millainen raportti pitäsi kirjoittaa, kun testaa jotakin tietokoneella? Nämä ohjeet on kirjoitettu Linux-kurssieni harjoitustehtäviä silmällä pitäen, mutta ne soveltuvat minkä tahansa tietokoneiden teknisten testien raportointiin. Näitä ohjeita on toivottu monesti.

Raportointi tarkoittaa, että kerrot täsmällisesti mitä teit, ja mitä sitten tapahtui. Kirjoita raporttia koko ajan samalla kun teet. Helpointa on kirjoittaa raportit suoraan sähköiseen muotoon.

Kirjoitan yleensä muistiinpanot jo itseänikin varten, kun tutkin jotain teknistä ongelmaa. Aikaa säästyy, kun ei tarvitse turhaan toistaa vaivalloisia koejärjestelyjä. Myös ajatukset selkenevät, kun kirjoittaa jäsenneltyjä muistiinpanoja. Raportteja voi käyttää pohjana, kun laatii toisille ohjeistoja järjestelmien toteutukseen ja ylläpitoon.


Toistettava

  • Jos annan rapotin toiselle opiskelijalle samassa ympäristössä, pitää tulla sama tulos kaikkine harhapolkuineen
  • Raportoi myös ympäristö. Moni asia toimii eri tavalla, jos käyttää eri tietokonetta eri verkossa. Esimerkiksi: “Tein harjoituksen perjantaina 2006-05-19 Helia-talon tietokonelaboratoriossa h5013. Koneena oli Dell GX270 työasema, monitorin jalassa oli numero 17. “.


Täsmällinen

  • Minkä komennon annoit tai mitä klikkasit?
  • Kellonajat. Samalla selviää, miten paljon eri työvaiheisiin menee aikaa. Aikoja vertaamalla voi jälkeenpäin päätellä, onko jokin vika ollut koko verkon laajuinen.
  • Onnistuiko? Mitä toimenpiteen jälkeen tapahtui? Jos jokin tehtävä onnistui tai epäonnistui, millä testillä totesit tämän? Esimerkiksi vikailmoitus “tietokone ei toimi” on aika lailla hyödytön.
  • Onko työkaluissa (Ubuntussa, IDEssä…) vikaa? Raportoi odottamattomat tulokset. Lähetän toistettavat virheraportit mahdollisuuksien mukaan ohjelmien tekijöille. Ehkä vika on korjattu, kun tarvitset ohjelmaa töissä.
  • Onko labrassa tai koneissa vikaa? Lähetä täsmällinen vikailmoitus suoraan osoitteeseen juhani.ahlgren palvelimella helia.fi. Käytännössä vikoja korjataan ainoastaan ilmoitusten perusteella.
  • Kirjoita menneessä aikamuodossa eli imperfektissä: “valitsin ‘tyhjennä’“, “irroitin johdon”, “laitteesta alkoi nousta savua”.


Helppolukuinen

  • Käytä väliotsikoita
  • Kirjoita huolellista kieltä. Luottasitko sellaseen hammasläkäriin, jonka wepisilvulla hirveesti on kirjotusvirhietä?
  • Kirjoita kanavaan sopivasti. Weppisivulla ei tarvitse noudattaa Helian paperijulkaisuihin tarkoitettuja ohjeita.
  • Jos haluat, voit kirjoittaa lopuksi yhden kappaleen tiivistelmän raportin alkuun “Asensin onnistuneesti Apache-weppipalvelimen ja käyttäjille mahdollisuuden tehdä kotisivuja. Kuvailen myös epäonnistuneen yrityksen asentaa PHP-skriptien tuki.”


Viittaa lähteisiin

  • Hyvä tapa ja akateeminen käytäntö vaatii viittauksia. Viittaukset osoittavat myös, että kirjoittaja on perehtynyt alueeseen.
  • Esimerkkejä:


Vakiotekstejä

Lisenssin valinta on vapaaehtoista, mutta GPL on suositeltava lisenssi.


Pahoja mokia

  • Sepittäminen. Ei saa väittää, että olisi tehnyt testejä, joita ei ole oikeasti tehnyt. Vain tehtyjä töitä saa raportoida. Kun sepitteissä tapahtuneita asioita yritetään turhaan toistaa, tuhrautuu rutkasti aikaa. (Sepittäminen on rangaistavaa vilppiä)
  • Plagiointi. Tekstin kopioiminen lähdettä ilmoittamatta tai toisten tulosten esittäminen ominaan. (Plagiointi on rangaistavaa vilppiä. Luvaton kopiointi loukkaa tekijänoikeuksia)
  • Kuvien luvaton kopiointi wepistä osaksi työtä. (Plagiointi on vilppiä. Luvaton kopiointi loukkaa tekijänoikeuksia).

Verkossa on myös paljon kuvia, joita saa yhdistää omiin töihin. Lähde on aina ilmoitettava. Kotitehtävissä työn tulee olla pääosin opiskelijan itse tekemä.


Posted in Old Site | Tagged | 15 Comments

15 Responses to Raportin kirjoittaminen

  1. Pingback: Viikko 4: Julkisen virtuaalipalvelimen pystyttäminen ja kokeilu – Linux Palvelimet ict4tn021, Tomi Salin

  2. Pingback: Aikataulu – Linux palvelimet ict4tn021 4-ti ja 5-to – alkusyksy 2017 – 5 op | Tero Karvinen

  3. Pingback: Linux palvelimet 1. viikko – Linux Palvelimet

  4. Pingback: Tehtävä 1 – Site Title

  5. Pingback: Xubuntu live-usb tikun tekeminen – Site Title

  6. Pingback: Kotitehtävä 1: Linux:n asennus ja kokeilu. | Andrei Saltokov

  7. Pingback: Kotitehtävä: Ubuntun asennus | jkmala

  8. Pingback: Linux:n asennus VirtualBox:n avulla | mimhee

  9. Pingback: Työasemat ja Tietoverkot: Linuxin Asennus | janitapaninenhh

  10. Pingback: h1 | My IT Studies

  11. Pingback: Xubuntu-polttaminen usb-tikulle ja kokeilu | Plannee

  12. Pingback: Linux (Xubuntu) live-cd:n poltto ja testaus | jenniniemela

  13. Pingback: Aikataulu – Työasemat ja tietoverkot ict1tn002-43 keväällä 2014 | Tero Karvinen

  14. Pingback: Aikataulu – Työasemat ja tietoverkot ict1tn002-33 syksyllä 2012 | Tero Karvinen

  15. Pingback: Aikataulu – Työasemat ja tietoverkot ict1tn002-34 Linux-osuus keväällä 2013 | Tero Karvinen

Leave a Reply

Your email address will not be published. Required fields are marked *

*

*

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

  • Picks

  • Boxing Clock for AndroidOcton8 Diving T-ShirtsShaking Tower Panda Android GameLearn Chinese with Android
  • Student projects