No Brasil, cerca de 68% da população é classificada como leitores com baixos níveis de alfabetização, isto é, possuem o nível de alfabetização rudimentar (21%) ou básico (47%), segundo dados do INAF (2009). O projeto PorSimples utilizou as duas abordagens de Adaptação Textual, a Simplificação e a Elaboração, para ajudar leitores com baixo nível de alfabetização a compreender documentos disponíveis na Web em português do Brasil, principalmente textos jornalísticos. Esta pesquisa de mestrado também se dedicou às duas abordagens acima, mas o foco foi o gênero de textos instrucionais. Em tarefas que exigem o uso de documentação técnica, a qualidade da documentação é um ponto crítico, pois caso a documentação seja imprecisa, incompleta ou muito complexa, o custo da tarefa ou até mesmo o risco de acidentes aumenta muito. Manuais de instrução possuem duas relações procedimentais básicas: a relação gera generation (quando uma ação gera automaticamente uma ação ), e a relação habilita enablement (quando a realização de uma ação permite a realização da ação , mas o agente precisa fazer algo a mais para garantir que irá ocorrer). O projeto aqui descrito, intitulado NorMan, estudou como as relações procedimentais gera e habilita são realizadas em manuais de instruções, dando base para a criação do sistema NorMan Extractor, que implementa um método de extração de termos dedicado ao gênero de textos instrucionais, especificamente aos manuais técnicos. Também foi proposta a adaptação do sistema de autoria de textos simplificados criado no projeto PorSimples o SIMPLIFICA para atender o gênero de textos instrucional. O SIMPLIFICA adaptado usa a lista de candidatos a termo, gerada pelo sistema NorMan Extractor, com duas funções: (a) para auxiliar na identificação de palavras que não devem ser simplificadas pelo método de simplificação léxica baseado em sinônimos, e (b) para gerar uma elaboração léxica para facilitar o entendimento do texto / In Brazil, 68% of the population can be classified as low-literacy readers, i.e., people at the rudimentary (21%) and basic (47%) literacy levels, according to the National Indicator of Functional Literacy (INAF, 2009). The PorSimples project used the two approaches of Textual Adaptation, Simplification and Elaboration, to help readers with low-literacy levels to understand Brazilian Portuguese documents on the Web, mainly newspaper articles. In this research we also used the two approaches above, but the focus was the genre of instructional texts. In tasks requiring the use of technical documentation, the quality of documentation is a critical point, because if the documentation is inaccurate, incomplete or too complex, the cost of the task or even the risk of accidents is greatly increased. Instructions manuals have two basic procedural relationships: the relation generation (by performing one of the actions (), the other () will automatically occur), and the relation enablement (when enables , then the agent needs to do something more than to guarantee that will be done). The project presented here, entitled NorMan, investigated the realization of the relationships between procedural actions in instruction manuals, providing the basis for creating an automatic term extraction method devoted to the genre of instructional texts, specifically technical manuals. We also proposed an adaptation of the authoring system of simplified texts created in the project PorSimples - the SIMPLIFICA - to deals with the genre of instrumental texts. The new SIMPLIFICA uses the list of term candidates, generated by the proposed method, with two functions: (a) to assist in the identification of words that should not be simplified by the lexical simplification method based on synonyms, and (b) to generate a lexical elaboration to facilitate the comprehension of the text

Software development is a growing part of many businesses today. The software development approach that is used to develop new software may have a positive or negative impact on the efficiency and quality of the final software product. The objective of this thesis was to propose a refined software development approach and to test it empirically. The software development approach is comprised of three main subcomponents: development style, development architecture, and technical documentation. The software development approach was applied in a case study in cooperation with Ericsson. At the completion of the case study, questionnaires were administered to Ericsson employees to evaluate the success of the software development approach. The results showed that the quality of the software product was high and Ericsson was pleased with the result. The results indicated that the development approach helped the case study be successful in some of the researched areas. The end results suggest that the proposed software process has the potential to be successful in other projects of a similar type and structure.

IST is a company that develops software for the education sector. The company's growth has led to inconsistency in its software suite, negatively impacting user and developer experience. User interface components such as buttons and forms vary in design and implementation across their services, making it challenging for users to navigate and for developers to maintain. To improve this, IST has started a project to switch to a different front-end architecture, known as micro-frontend, which will need to be accompanied by technical documentation. This project is referred to as ‘CommonUI’. Reading and contributing to documentation, especially for software, is indicated by existing literature to be perceived unappealing by developers. This thesis aims to explore developers' attitudes toward documentation and proposes Developer Experience-oriented features. The method process involves a literature review, semi-structured interviews and identifying themes using thematic analysis. The findings reject the hypothesis that developers find documentation unappealing, indicating that most developers view engaging with documentation positively, motivated by altruism. Key themes identified from the interviews include the need for examples, up-to-date, concise text, and easily findable documentation. Proposed features to improve the Developer Experience include interactive component examples, integration of documentation with design specifications, dynamic presentation of code from source files, mechanisms for user feedback, text limitations, and enhanced search functionality.

Práca sa zaoberá automatizáciou testovania technickej dokumentácie napísanej v značkovacom jazyku AsciiDoc pomocou open-source frameworku testovania technickej dokumentácie Emender implementovaného na CI/CD platforme. Framework bol rozšírený o webovú aplikáciu emenderwebservice s REST API, ktorá poskytuje užívateľské grafické rozhranie s výsledkami testov a mechanizmom na odrieknutie falošne pozitívnych výsledkov testov. Webová aplikácia bola vytvorená pomocou WSGI frameworku na tvorbu webových aplikácií Flask s databázou ktorá umožňuje agregáciu výsledkov testov a ich unikátnu identifikáciu. Aplikácia uľahčuje prístup ku výsledkom testov vygenerovaných frameworkom Emender v CI/CD systémoch a poskytuje technical writer-om ucelené užívateľské prostredie.

Cette étude est fondée sur deux constats dans le domaine de la maintenance aéronautique : l’utilisation non systématique de la documentation de maintenance aéronautique (DMA) malgré la prescription légale et l’évolution technologique qui a entraîné l’introduction de l’utilisation de l’appareil à petit écran ou mobile pour la consultation et la recherche d’information pour la réalisation de la tâche de maintenance. L’objectif de cette étude est double : identifier les raisons de la sous utilisation de la DMA et contribuer à la conception d’une documentation de maintenance adaptée à la fois aux supports mobiles (PDA), à l’utilisateur et au contexte de la maintenance aéronautique. Des tests d’utilisabilité ont été menés et testaient l’hypothèse selon laquelle l’utilisation du petit écran a un effet négatif sur les performances des utilisateurs. Des observations et entretiens dans les centres de maintenance ainsi que des tests sur avion ont aussi été conduits pour évaluer la lisibilité de l’interface et la portabilité des appareils mobiles. Les résultats montrent que les raisons de la non utilisation de la documentation de maintenance sont principalement liées à la non adaptation de celle-ci aux utilisateurs et au contexte du métier, que l’utilisation du petit écran est envisageable aussi bien pour une application destinée aux petits écrans que pour celle destinée aux écrans standard. En outre, l’utilisation du petit écran ne détériore pas, d’une façon générale, les performances des utilisateurs et qu’elle est envisageable aussi bien chez les novices que chez les experts qui sont encore réticents mais n’y sont pas opposés. / Literature review shows that maintenance operators do not use the aircraft maintenance documentation (AMD) systematically despite the legal obligation. The aim of this study is to contribute to the identification of users’ difficulty about the use of the AMD and the designing of maintenance documentation well-adapted to mobile devices (PDA), to users and to aircraft maintenance context. Hypothesis consists on verifying the effect of the small screen use on users’ performances. According to the usability test results, the small screen use has no negative effect on the users’ (experts and novices) performances. Field studies in maintenance centers and on aircraft show that small screen use is suitable to novices and experts for small screen documentation consultation and also for standard screen documentation when consultation is limited. Some users, particularly experts, are hesitant about using small screen for information consultation. However, they are not against the use of such format if information display is improved. Results are not limited to small screen documentation issue, some parts (e.g. information display study to reduce user effort) could be generalised to information system for task support.

The aim of this master thesis is to resolve the problems based on requirements of the company. Initially a theoretical part was prepared which is focused on configuration management and related terms of a particular problem. After theoretical introduction it was systematically approached to the problem and a possible solution was proposed based on analysis of the current situation taking into account configuration management. The solution was to create a technical-organizational guideline which is a tool for the elimination of errors of employees and for general overview. The final technical-organizational guideline can be found in the attachment and in the main part of this thesis describes development of the guideline.

This report describes Bigraphical DSL (BDSL), a domain-specific language for reactive systems, rooted in the mathematical spirit of the bigraph theory devised by Robin Milner. BDSL is not only a platform-agnostic programming language but also a development framework for reactive applications, written in the Java programming language, with a focus on stability and interoperability. The report serves as a user manual mainly elaborating on how to write and execute BDSL programs, further covering several features such as how to incorporate program verification. Moreover, the manual procures some best practices on design patterns in form of code listings. The BDSL development framework comes with a ready-to-use interpreter and may be a helpful research tool to experiment with the underlying bigraph theory. The framework is further intended for building reactive applications and systems based on the theory of bigraphical reactive systems.:1 Introduction 1.1 Bigraphical Reactive Systems and Programming . . . . . 1.2 Installation 1.3 How to write and run BDSL programs? 1.4 Further Help 1.5 Remarks 2 General Usage of the BDSL Interpreter Tool 2.1 The CLI Interpreter of BDSL 2.2 Supplying a BDSL Program to the Interpreter 2.3 Externalized Configuration 3 BDSL Program Structure 3.1 Elements of a BDSL program 3.2 Main Block 3.3 Scoping, Namespaces and Imports 3.4 Classes and Variables 3.5 Event Listeners/Callbacks 4 Predefined Methods in BDSL 4.1 Printing to the Console 4.2 Loading Bigraphs 4.3 Synthesizing Random Bigraphs 4.4 Exporting Bigraph Variables 4.5 Executing BRSs 5 Examples 5.1 Basic Mathematical Calculations the Bigraphical Way 5.2 Importing External Libraries 5.3 Pathfinding: Naive Blind Search 5.4 Mutual Exclusion Problem 6 Advanced Topics 6.1 User-defined Functions 6.2 Using the Interpreter Programmatically 6.3 IDE Support 7 Conclusion 7.1 Future Work References Appendix A Configuration File for the BDSL Interpreter B BDSL Sample Programs C Using the BDSL Interpreter Programmatically

The iTour Project is an empirical study of the design of online interactive animated tours (iTours), and establishes a knowledge base for technical communicators and new media designers working in this area. The key objectives of this research were to understand the features of effective iTours; to explore the processes and techniques of designing and testing effective iTours; and to establish new praxis in new media design for technical communication. Design artefacts resulted from six key activities including: (1) Sub-project 1- RMIT Multimedia Online documentation with basic animation; (2) Sub-project 2- Online @ RMIT Orientation with some iTour animation; (3) Third-party iTour analytical review to deconstruct iTours and determine key elements; (4) Sub-project 3- Online @ RMIT iTours; (5) iTour Guidelines; and (6) A second, more comprehensive third-party iTour analysis to test the Guidelines. The outcome of the research is encapsulated in a web site that binds the artefacts of design sub-projects with a set of Guidelines. These Guidelines form a conceptual, structural and operational framework for iTour designers, and draw on the knowledge established while designing and testing iTours, analysing third-party iTours, and researching comparative fields. These fields include technical communication; new media; web; usability design and testing; and, to a lesser extent, software design and testing. The Guidelines, in conjunction with the knowledge base, were developed to facilitate effective communication through iTours. Through this research, the design action case study was established as a hybrid research approach: design research and action research are blended; and knowledge is situated within, and derived from, a case study. In support of design research, the PDIOR design cycles have been specified and include these phases: plan; develop; implement; observe; and reflect. The PDIOR approach combines design research and action research in a cyclical mode to explore technical communication and new media activities. Finally, eleven principles for designing effective iTours emerged from this research project. Articulation of these principles, in addition to the Guidelines, contributes new knowledge in the field for technical communicators, new media designers and others, who wish to engage in iTour design.

This diploma thesis focused on designing of systematic wiring of multifunctional sports centrum. The work is divided into two parts. The first part of the work is dealing with definitions and principles necessary for electrical project documentation. There is a presentation of the KNX bus control system, which is chosen for the implementation of the systematic wiring of the sports centrum. There is also an overview of currently used systems for wiring control. At the end, the design of artificial and emergency lighting is processed using a computer program. The content of the second part of the work is a complete project documentation for construction of the multifunctional sports hall using the KNX bus system. Furthermore, the documentation draws the design of power and data distribution to the relevant floor plans of the building, the design of power and system switchboards, an overview scheme of power distribution, topology of the KNX system, budget and technical report.

This master’s thesis is devoted to rifling technologies of the barrel bore of fire and gas arms. In cooperation with the company Winston Production, s.r.o. also enters into operation issues of selected manufacturing machine Zs 151 for barrel rifling. It contains an analysis of legislative demands on the technical documentation, description of the construction and function of machinery and materials for the creation of local operating safety rules for its operation. The part of work is also 3D model of the machine created in software SolidWorks.