Submitted by Maike Costa (maiksebas@gmail.com) on 2017-06-29T13:16:35Z No. of bitstreams: 1 arquivototal.pdf: 5298255 bytes, checksum: 86813ce5eab1b4b77b7cc4359031e69c (MD5) / Made available in DSpace on 2017-06-29T13:16:35Z (GMT). No. of bitstreams: 1 arquivototal.pdf: 5298255 bytes, checksum: 86813ce5eab1b4b77b7cc4359031e69c (MD5) Previous issue date: 2017-03-24 / The subject of this work is the use of a lightweight markup language (Markdown) to write dissertations and theses according to the ABNT rules. This document shows the devel- opment of Limarka, a tool that makes possible to write dissertations and theses with a lightweight markup language, and a experiment involving ten students writing a proposal of dissertations or theses. The methodology used was unstructured interviews with qual- itative analysis. The objectives of this research are: implement a tool to make possible write dissertations and theses according to the ABNT rules and evaluate its usage. The main outcomes of this research comes from two sources: 1) knowledge acquired from the de- velopment of the application. They are: a dissertation or a thesis cannot be produced from a tool that uses the DocBook format as a intermediary format. The abnTeX communite makes available templates according to the ABNT rules. The use of a Latex templates based from abnTeX text. And the generation of Latex Code from Markdown texts. 2) knowledge acquired from the analysis of experiments. They are: For the configuration of the template, the use of PDF form instead of making YAML code. There are evidences that Markdown and Latex are equivalent, in capabilities, and users will find the usage of a lightweight markup language easier to learn and use than Latex. The main conclusion of this work is that it is possible to write a dissertation or a thesis using a lightweight markup and produce documents according to the ABNT rules. / O tema deste trabalho é a utilização de uma linguagem de marcação leve (Markdown) para elaboração de trabalhos de conclusão de curso em conformidade com as Normas da ABNT. Nele relata-se o desenvolvimento da ferramenta Limarka, que possibilitá a es- crita de TCC através de uma linguagem de marcação leve, e um experimental, com dez alunos elaborando propostas de TCCs nela. A metodologia empregada foi experimento com entrevistas semi-estruturadas e análise qualitativa. Os objetivos da pesquisa são: im- plementar uma ferramenta que possibilite a escrita de TCCs em conformidade com as Normas da ABNT e avaliar sua utilização. Os principais resultados da pesquisa tiveram duas fontes: 1) Conhecimentos resultantes do desenvolvimento da aplicação. São eles: um TCC não deve ser produzido por ferramentas que utilizem o formato DocBook como in- termediário; a comunidade abnTeX oferta uma ótima alternativa em Latex para produzir TCCs nacionais em conformidade com as Normas da ABNT; a utilização de um template baseado no modelo de TCC do abnTeX e a geração de códigos Latex a partir de Mark- down possibilita a geração de trabalhos em conformidade com as Normas da ABNT; 2) Conhecimentos provenientes da análise do experimento. São eles: para a configuração do template, a utilização de um formulário PDF, em vez de código YAML, torna o processo de configuração mais fácil; A solução com escrita em Markdown apresentam equivalência de expressividade ao Latex, pois permite a inserção de seus códigos; existem indícios de que os usuários acharão mais fácil aprender e utilizar Markdown do que Latex. A princi- pal conclusão do trabalho indica que é possível utilizar uma linguagem de marcação leve (Markdown) para escrita de TCCs nacionais em conformidade com as Normas da ABNT. E sua utilização deve ser incentivada pois é expressivamente equivalente a Latex, porém mais simples e fácil de ser utilizado.

The aim of this thesis is to develop an educational methodology for the following languages: Markdown, HyperText Markup Language (HTML), eXtensible Markup Language (XML) and Scalable Vector Graphics (SVG); and to verify the methodology at Czech elementary schools on the lower secondary level. An integral part of the methodology is also an introduction to the history and development, as well as the theory of syntax of the mentioned markup languages, necessary for teaching according to this methodology. The methodology uses specific examples, on which the students can verify their newly acquired knowledge in practice. The verification of the methodology took place in the form of teaching at two Czech elementary schools. The teaching took place in the seventh grade within the compulsory elective subject of informatics, in the ninth grade within a compulsory subject. The expected differences in understanding the markup languages education in favor of the ninth year have not been confirmed. The motivation of the students proved to play much greater role than their age. The verification of the methodology has shown that it is necessary to pay careful attention to the precise formulation of the task assignments and guidelines to the students, to avoid confusion and substitution of the source code of the...

Architectural documentation is crucial in the development process, as it helps developers understand the system’s architecture and make informed decisions. However, conventional documentation methods are often timeconsuming and error-prone since most of the work is done manually. This becomes even more ambiguous whendealing with complex systems and when requirements are prone to changing during the development process. This thesis addresses these challenges by exploring the potential benefits of utilizing object-oriented documentation tools and plugins to improve the efficiency of writing and maintaining architectural documentationwhile also making sure that the conveyed information is sufficient and understandable for junior developers. Moreover, it investigates the possibility of generating an easy-to-maintain context view with the use of metadatato display architectural information. The thesis employs both a qualitative case study as well as a rapid application development (RAD) approach.The case study involves interviewing junior developers to find patterns in what junior developers look for inregards to understanding a system’s architecture. Using the RAD approach, a prototype system is developedthat utilizes DollarDoc to treat documentation components as objects by being able to refer to these objectsfrom one file to another. The result shows how architectural documentation can be designed to effectively communicate critical aspects of the system’s architecture to junior developers by providing a clear overview of its components. Thiscontributes to a better understanding of the system’s functionality and purpose, leading to increased productivity and engagement. By using object-oriented documentation tools, the documentation structure becomesmore maintainable, allowing for automatic updates and reliable information.