Metodika

Cieľom je vytvoriť metodiku na vybraný aspekt vývoja, nasadenia alebo údržby softvérového systému v softvérovom projekte. Jednotlivé témy sa špecializujú na rôzne platformy podľa znalostí a skúseností jednotlivého študenta, pričom sa preferuje rozsah projektu, pre ktorý sa metodika vytvára tak, že ide o projekt podobného charakteru ako projekt v predmete Tímový projekt.

• Termíny odovzdania v zmysle harmonogram predmetu
• O tvorbe metodík
• Ukážky metodík z minulých rokov
• Témy metodík
• Ako na to
• Hodnotenie

O tvorbe metodík

Cieľom vytvorenia metodiky je zvýšenie kvality, či už zdokumentovaním nejakého know-how alebo zadefinovaním jednotných pravidiel, resp. kritérií pre istú činnosť alebo produkt.

Metodika

• podrobne a formálne opisuje procesy a súvisiace produkty (dokumenty) v konkrétnom prostredí,
• určuje poradie vykonávaných procesov, roly a zodpovednosti v týchto procesoch, vstupné a výstupné dokumenty,
• stanovuje pravidlá, určuje podmienky a faktory pre rozhodovanie.

Metodika môže zachytávať procesy a činnosti na rôznych úrovniach. Môže byť návodom na prácu s konkrétnym prostriedkom, správnym a úplným vyplnením/vytvorením konkrétneho dokumentu, odporúčaním a zdokumentovaním jedného kroku v širšom meradle procesu tvorby produktu. Podobne môže definovať pravidlá, činnosti a dokumenty spojené s manažmentom istej oblasti tvorby produktu.

Vašou úlohou bude, na základe vašich skúseností a znalostí, navrhnúť a zdokumentovať metodiku pre vybrané oblasti tvorby softvéru. Metodiky vytvoríte pre dve základné úrovne procesov:

• Manažment procesov v kontexte etáp celého životného cyklu softvéru (vyššia úroveň)
• Jeden alebo viac procesov (na základe dohody s cvičiacim) v užšie ohraničenom prostredí a podmienkach (nižšia úroveň)

Metodika je

• formálny, technický, normatívny dokument. Tieto atribúty sa prejavujú v štruktúre dokumentu, ako aj vo zvolenom jazyku či úpravách.
• vecná, používa stručné, pomerne jednoduché vety. Z viet musí byť jasné kto-čo-ako-kedy. Spravidla sa zámená nepoužívajú, aby sa predišlo viacznačnosti.

Informácie v metodike sa často sumarizujú v tabuľkách alebo diagramoch. Texty sa vyznačujú strohosťou, častým používaním zoznamov a číslovaných zoznamov.

to Homepage

to Teaching

to MSI

to the Top

Ukážky metodík z minulých rokov

Úryvky metodík z minulých rokov (PDF):

• [Dobrá metodika] Organizácia dokumentu, formálna stránka: proces manažmentu revízií
• [Dobrá metodika] Úvod dokumentu, slovník pojmov, opis procesu a kroku
• [Dobrá metodika] Úvod dokumentu, použité pojmy (odkazy obyčajne v úvode, môžu byť stručnejšie)
• [Slabá metodika] Zníženie prehľadnosti zlou organizáciou textu (porušenie formálnosti)
• [Slabá metodika] Neprehľadný text, skôr esej (porušenie technického jazyka)

to Homepage

to Teaching

to MSI

to the Top

Ako na to...

• pre dve základné úrovne procesov - z pohľadu obsahu vytvoríte metodiku (t.j. jeden ucelený text/materiál) špecifikujúcu:
  • manažment úloh v kontexte etáp celého životného cyklu softvéru – v tejto úrovni definujete zodpovednosti a opíšete spôsob realizácie vybranej problematiky z komplexného pohľadu.

    Príklad: Opíšete celkový spôsob vytvárania, sprístupňovania a uchovávania technickej dokumentácie v rámci fiktívnej firmy.

  • konkrétny proces alebo dokument v užšie ohraničenom prostredí a podmienkach – v tejto úrovni podrobne opíšete vybranú časť resp. krok z predchádzajúcej časti tak, že opíšete použitie konkrétneho prostriedku/nástroja na vykonanie tejto činnosti.

    Príklad: Opíšete presný postup, ktorý je potrebné vykonať pri vkladaní nového a modifikácii exitujúceho dokumentu v rámci SVN repozitára.

  • z úvodu oboch častí metodiky musí byť jasné, čomu sa daná časť venuje; obe časti sa budú na seba vzájomne odkazovať tak, aby bolo jasné, ktorý čiastkový proces rieši metodika na dolnej úrovni, a kde tento patrí v metodike na hornej úrovni.

• téma metodiky
  • výber zo zoznamu tém metodík po vzájomnej dohode v tíme, pričom musia byť dodržané tieto pravidlá:
    • každý študent si musí vybrať jednu z tém metodiky prislúchajúcej jeho manažérskej role v tíme
    • v každom tíme môže byť max. 1 študent s rovnakou témou metodiky
  • na konzultáciu k metodikám každý prinesie minimálne štruktúru metodiky
• odovzdanie
  • podľa harmonogramu
  • odovzdanie bude elektronicky vo formáte pdf a tiež nezmenené vo vytlačenej podobe v termíne podľa harmonogramu
• formálna stránka metodiky

  • metodiku treba spracovať v štýle, ktorý zodpovedá technickému dokumentu a odovzdať vo formáte pdf do AIS s dodržaním mena súboru v tvare
    metodika2012-<cislo-skupiny>-<cislo-timu>-<meno-v-AIS>.pdf,
    napr. metodika2012-05-01-xmrkvicka.pdf

  • odporúčaný rozsah metodiky je 7-8 strán, minimálne však 6 strán čistého textu formátu A4, t.j. 6 strán bez obrázkov, príloh, schém a pod. Celkový počet strán ako taký je len orientačný, keďže napríklad niektoré metodiky budú obsahovať niekoľko obrazoviek rozhrania, ktoré len samotné môžu zabrať niekoľko strán. Zároveň však v prípade, že by metodika mala prekročiť 10 strán A4, treba toto konzultovať s cvičiacim.
    V prípade špecifických podmienok alebo nejasností odporúčam konzultovať na stretnutí. Alebo inak, odporúčam konzultovať na stretnutí v každom prípade.

  • metodika musí byť napísaná technickým štýlom vhodným pre tento typ dokumentu
  • metodika musí byť vhodne štruktúrovaná
  • metodika musí byť napísaná po slovensky
  • nesmie obsahovať pravopisné chyby
  • musí obsahovať všetky požadované časti (pozri ďalej štruktúru metodiky)
• štruktúra metodiky - metodika musí obsahovať
  • názov podľa zadania (je vhodné názov upraviť na základe zvolenej špecializácie a konkretizácie)
  • meno autora, fakulta, univerzita
  • samotný text metodiky, pričom nezabudnite na:
    • vymedzenie obsahu,
    • dedikáciu metodiky (kto sa ňou riadi, kedy),
    • zoznam nadväzujúcich metodík a dokumentov,
    • roly a zodpovednosti účastníkov,
    • vymedzenie pojmov,
    • vymedzenie skratiek,
    • podrobné opisy procesov-postupov.
  • súčasťou metodiky môžu byť prílohy (diagramy, formuláre, zoznamy konkrétnych osôb podľa rolí a kontakty a pod.).

to Homepage

to Teaching

to MSI

to the Top

Hodnotenie

• na metodike sa hodnotí
  • obsah (z pohľadu zadanej témy a vybranej špecializácie)
  • náročnosť problematiky
  • spôsob spracovania (či ide iba o jednoduchý všeobecný problém, na ktorý existuje množstvo metodík, ucelenosť, logický sled krokov, štýl, vecnosť,...)
  • formálna stránka (štruktúra, slovenčina, obrázky, tabuľky a odkazovanie na ne, konzistentný štýl)
  • dostatočný prehľad v danej oblasti a kvalifikované návrhy postupov
• hodnotenie za metodiku sa môže znížiť až o 10 bodov najmä za
  • väčšie množstvo gramatických chýb
  • neprimerané miešanie angličtiny a slovenčiny

to Homepage

to Teaching

to MSI

to the Top