Principy pro formu a vzhled automaticky generovaných dokumentací

Název práce: Principy pro formu a vzhled automaticky generovaných dokumentací
Autor(ka) práce: Svobodová, Kateřina
Typ práce: Diplomová práce
Vedoucí práce: Bruckner, Tomáš
Oponenti práce: Doležel, Michal
Jazyk práce: Česky
Abstrakt:
Nedostatečná uživatelská přívětivost automaticky generovaných dokumentací odrazuje programátory od jejich využívání. Zlepšení uživatelské přívětivosti může pomoci jak začátečníkům tak expertům během vývoje software. Výsledkem práce je soubor principů pro automaticky generované dokumentace ze zdrojového kódu, aplikace principů a výsledky měření účinnosti změn. Práce je zpracována dle metody Design Science Research zaručující kvalitní design založený na konstruktivním výzkumu. Univerzální principy pro formu a vzhled automaticky generovaných dokumentací byly sestaveny pro vyřešení problémů odhalených expertním posudkem a neformálním posudkem a problémů zjištěných z rešerše odborných článků. Identifikované principy jsou aplikovány na dokumentaci knihovny Requests4J pro programovací jazyk Java. Dokumentace po aplikaci principů byla podle uživatelského testování přívětivější než původní dokumentace, což potvrzuje aplikovatelnost sestavených principů.
Klíčová slova: generátor dokumentace; HCI; softwarová dokumentace
Název práce: Best Practices for Form and Appearance of Automatically Generated Documentation
Autor(ka) práce: Svobodová, Kateřina
Typ práce: Diploma thesis
Vedoucí práce: Bruckner, Tomáš
Oponenti práce: Doležel, Michal
Jazyk práce: Česky
Abstrakt:
Insufficient usability of automatically generated documentations discourages programmers from using them. Improving usability can help both beginners and experts during software development. The result of this thesis is a set of best practices for automatically generated documentation from source code, application of those best practices and the results of measuring effectiveness of the changes. The thesis is conducted according to the Design Science Research method guaranteeing quality design based on constructive research. Universal best practices for the form and appearance of automatically generated documentation were compiled to address the problems found by an expert review and an informal review and the problems identified from a literature review of peer-reviewed articles. The identified best practices are applied to documentation from the Requests4J library for the Java programming language. The modified documentation was, according to the user testing, more user-friendly than the original documentation, confirming the applicability of the compiled best practices.
Klíčová slova: software documentation; documentation generator; HCI

Informace o studiu

Studijní program / obor: Kognitivní informatika
Typ studijního programu: Magisterský studijní program
Přidělovaná hodnost: Ing.
Instituce přidělující hodnost: Vysoká škola ekonomická v Praze
Fakulta: Fakulta informatiky a statistiky
Katedra: Katedra informačních technologií

Informace o odevzdání a obhajobě

Datum zadání práce: 4. 10. 2022
Datum podání práce: 1. 5. 2023
Datum obhajoby: 1. 6. 2023
Identifikátor v systému InSIS: https://insis.vse.cz/zp/82218/podrobnosti

Soubory ke stažení

    Poslední aktualizace: