Põhilised vead viki artiklites
Esitamine
- Kirjatöö esitamisel lisage enda andmed võimalikult täpselt: ees- ja
perekonnanimi, õppegrupp, valitud teema ja selle asukoht vikis. Palun
kontrollida viki artikli lingi toimimist enne esitamist. See kiirendab
ja lihtsustab oluliselt töö leidmist.
Viitamine
- Tekstilõigud, mis pole: üldteada, loogikareeglitest tuletatud või
autori argumentatsioon ja väited peavad viitama allikale.
- Iga lause ja lõigu puhul peab olema selge, kas see on autori enda
looming või refereeritud/tõlgitud/tsiteeritud ja seega olema viidatud!
- Tsitaadid ja nende tõlked peavad olema ülejäänud tekstist eristatavad
(näiteks jutumärkide sees)
- Piltide juures pole viiteid (viidata tuleb allikale, kui pilt pole ise
loodud)
- Pildile endale tuleb teksti seest viidata (Näiteks teenuse arhitektuur
on kajastatud joonisel 1.
Sissejuhatus
- Tihti algab sissejuhatus poolelt teelt. Mõelge, et lugeja on EIK'i
tudeng, kuid ei pruugi antud ainest midagi teada ja ei saa eeldada, et
ta teab miks antud kirjatükk loodi. Eesmärk, mida soovitakse öelda peab
sissejuhatuses kirjas olema.
- Ärge eeldage, et lugeja teab teie teemat ja seetõttu tuleb selle kohta
mõned üldised sissejuhatavad laused kirjutada.
Släng
- Serverid ei „kärssa”
- Programmid ei „jookse” vaid „töötavad”.
Liigne info
- Te ei saa kirjeldada aboluutselt kõike ja lugeja pole sellest ka
huvitatud. Ei ole mõtet seletada VirtualBox’i paigaldamist ja
kasutamist, kui teemaks on näiteks NTP teenuse seadistamine.
Tehnilised vead
- Tihti on näha, et referaadi tehniline osa ei pea paika. Näiteks
tehakse referaat mõnes tekstitöötlusvahendis, mis vahetab lühikesed
miinused pikkade vastu ja jutumärgid ning ülakomad muudab samuti ära.
Mõnel puhul muudetakse algustähti suurteks ja tõesti käsk Ls ja Cp ei
tööta!
- Tihti jäetakse käsule, mis tuleb sisestada terminali # või muu
käsuviip ette ja käsud kopeerimisel ei toimi. Algajatele valmistavad
sellised juhendid parajat peavalu.
- Tihti pole kirjas, mis õigustes tuleb käske käivitada. Kui soovite, et
kõik käsud tuleb käivitada juurkasutaja õigustes, siis kirjutage see
sissejuhatuse lõppu või kasutage sudo korraldust Ubuntu/Debian
süsteemides.
Kokkuvõte
- Autori arvamus on oluline ja kokkuvõttes peaks eelneva jutu kokku
võtma (mida tehti, miks tehti, mida autor arvab jne)
Allikad
- Allikad, millele viidatakse peavad olema ajakohased ja refereerida
tuleb originaali, mitte referaati. Näiteks vikipeedia on referaat, kus
originaalloomet ei ole ja seetõttu pole ilma mõjuva põhjuseta hea
sellele viidata.
Kategooria
- Kuna referaadi esitamine toimub meil wiki.itcollege.ee kaudu, siis
tuleb kirjatükile lisada õige kategooria viki lähtekoodis viimasesse
ritta, näiteks
[[Category: Operatsioonisüsteemide
administreerimine ja sidumine]]
aine „Operatsioonisüsteemide
administreerimine ja sidumine” puhul.