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.

No description available.

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.

La documentation et description du huastèque du sud-est (code d’Ethnologue HSF), une langue Maya du Mexique, est un projet doctoral en cotutelle entre l’ University of Sydney, Australie et l’Université Lyon 2 Lumière, France. La première partie de cette these (le Volume 1) consiste en la description grammaticale de cette langue Maya: sa phonologie, sa morphologie et sa syntaxe, ainsi que la description de l’expression de l’espace dans cette langue. Le Volume 2 de cette thèse représente les contes en HSF, une description deétaillée du projet de documentation, un long résumé en français, et les matériels pour la revitalisation de la langue. / The documentation and description of South Eastern Huastec (Ethnologue code HSF), a Mayan language from Mexico, is a PhD project carried out in cotutelle between the University of Sydney, Australia and the Université Lyon 2 Lumière, France. The first part (the Volume 1) of this thesis is a grammatical description of this Mayan language: its Phonology, Morphology, and Syntax, as well as its Space encoding. The second volume (the Volume 2) of this thesis comprises HSF stories, a detailed description of the documentation project, a detailed summary in French, and the HSF revitalization materials.

Essa dissertação visa investigar o legado do Departamento de Informação e Documentação Artísticas - IDART para a cultura paulistana. Criado em 1975, na cidade de São Paulo, teve uma importante trajetória que foi marcada, no entanto, por uma forte instabilidade institucional. O recorte temporal escolhido cobre de 1975 a 1982, período em que o IDART gozou de autonomia política e conceitual. Embora o Departamento tenha se tornado conhecido pelo seu Centro de Pesquisa, pretendemos demonstrar que ele se constituiu numa instituição muito mais complexa, dotada de uma estrutura organizacional singular. Para atingir nossos propósitos iremos primeiramente analisar o projeto que deu origem ao IDART, os antecedentes institucionais que serviram de base para o estabelecimento de suas matrizes conceituais, bem como a contribuição de diferentes intelectuais que estiveram envolvidos em sua concepção, com destaque para o papel preponderante desempenhado por Maria Eugênia Franco. Iremos também detalhar as atividades do Centro de Pesquisa (Centro de Documentação e Informação sobre Arte Brasileira Contemporânea), ressaltando o caráter pioneiro das metodologias e das rotinas de trabalho adotadas. Por fim, tentaremos evidenciar de que modo o IDART buscou conjugar as funções de centro de documentação às atribuições de uma instituição museológica, no que se refere à formação de coleções e difusão de conhecimento por meio de publicações e exposições didáticas. Em relação às fontes, utilizamos documentos de arquivos institucionais, sendo que uma parte deles foi tornada pública apenas recentemente, além de termos recorrido a um levantamento minucioso de matérias publicadas na grande imprensa com o intuito de cobrir certas lacunas. Todo o nosso esforço concentrou-se em propor uma revisão crítica da história institucional do IDART, em seus primeiros anos, como uma contribuição pontual para o estudo das políticas públicas da cultura no estado de São Paulo ao longo do século XX. / This dissertation aims to investigate the legacy left by the Departamento de Informação e Documentação Artísticas - IDART (Department of Artistic Information and Documentation) for São Paulo\'s cultural scene. Established in 1975 in the city of São Paulo, it had an important trajectory however marked by its strong institutional instability. We have chosen to focus on the years between 1975 and 1982 when IDART enjoyed a greater political and intellectual autonomy. Even though the Department has been recognized for its Research Center, we intend to show that it was indeed a much more complex institution with a singular organizational structure. In order to achieve this goal, we will first analyze IDART\'s original project, the organizational background that laid the ground for its conceptual matrix, and also the contribution offered by many intellectuals and scholars who were involved in its foundation, especially Maria Eugênia Franco who played a crucial role in this process. We will also further describe the activities of the Research Center (Center for the Documentation and Information on Brazilian Contemporary Art), highlighting how groundbreaking its methods and activities were. Finally, this dissertation aims to shed some light on how much IDART sought to combine the functions of a documentation center with the assignments of a museum institution, especially concerning the collections development, and the dissemination of knowledge through its publications and pedagogical exhibitions. As for the sources used for this work, we have analyzed documents from the organization\'s archives, recently made public, and a comprehensive overview of newspaper articles published about IDART that helped us to fill in some gaps left by the investigation. Our focus was on providing a critical perspective on IDART\'s institutional history during its first years, as well as on its contributions towards cultural policies implemented by the State of São Paulo in the 20th century.

A presente pesquisa teve por objetivo geral analisar os usos dos termos documentação, documento e objeto no contexto da área de museus. Tal contexto foi caracterizado em dois universos: o teórico, da literatura selecionada de caráter teórico da Documentação, Ciência da Informação e a Museologia, e o prático, composto por duas normas da área de museus. Os objetivos de trabalhar com estes dois universos foram mapear, caracterizar e problematizar ideias, tensões e aproximações entre os universos da teoria e da prática, sem a pretensão de se chegar a uma definição unívoca dos mesmos. Para alcançar tais objetivos, optou-se por uma metodologia exploratória, descritiva, comparativa e que se valeu de elementos de pesquisa histórica. No que se refere aos procedimentos, se realizou essencialmente levantamento bibliográfico e uso de ficha de coleta terminológica para o termo documentação - apenas para sistematizar significados e não para propor uma definição unívoca. A comparação entre os usos dos termos estudados apresentam polissemia e certa ambiguidade e, no que se refere particularmente ao termo documentação, ainda há um discurso que reitera a ideia de sua vinculação com a questão do controle das coleções. Os resultados desta investigação reforçam que a diversidade de significados influencia fortemente o que se realiza na prática profissional. Além disso, os usos consolidam diferentes tradições e formas de se conceber documentação e objetos-documentos nos museus - o que deve ser cada vez mais pesquisado para reforçar laços e rever conceitos e procedimentos. Por último, vale destacar que o propósito deste trabalho foi de explorar as diferenças terminológicas, tão inerentes ao universo dos museus, e colocar questões de como operar com elas e a partir delas. / The present study aimed to analyze the general uses of the terms documentation, document and object within the context of the museums field. This context was characterized in two universes: the theoretical, represented by selected bibliography taken from Documentation, Information Science and Museology, and practical, consisting of two standards of museums area. The objectives of working with these two universes were to map, characterize and discuss ideas, approaches and tensions between the worlds of theory and practice, without the intention of getting any unique definition. In order to get those objectives, an exploratory, descriptive, comparative methodology was chosen, that also drew upon elements of historical research. As regards procedures, bibliographic record and use of terminological data collection form for the term documentation were used, and this last one was only to systematize meanings and not to elaborate a unified definition. The comparison between the uses of the terms being studied point out their polysemy and ambiguity and, in the case of term documentation, the idea of its connection with the control of the collections still remains. Results of this study also reinforce this diversity of meanings strongly influences what is done in professional practice. Furthermore, it consolidates different traditions and ways of conceiving documentation and objects-documents in museums - which should be increasingly researched to reinforce ties and review concepts and procedures. Finally, it is worth noting that the purpose of this study was to explore the terminological differences, so inherent to the universe of museums, and raise the issue of how to deal with them and from them.

Made available in DSpace on 2016-04-27T19:30:49Z (GMT). No. of bitstreams: 1 Paula Ribeiro Salles.pdf: 46893265 bytes, checksum: 219bbdc83939fa498cda80801e475e50 (MD5) Previous issue date: 2013-10-14 / Conselho Nacional de Desenvolvimento Científico e Tecnológico / The Centro de Pesquisa e Documentação Vergueiro CPV (Vergueiro Research and Documentation Centre) is well-known for the documentation it has collected during the forty years since it was founded. This study analyses the historical circumstances that made it possible for the CPV to accumulate this documental heritage and describes the politics, ideas and practices of popular documentation and communication followed by the then Centro de Pastoral Vergueiro (CPV) in the 1970s and 1980s. The CPV, founded by Dominicans of the Christ the Worker Community in the south of São Paulo city, always maintained a pluralist political approach, working with trade union activists, community associations and a wide range of grassroots and official organisations in the progressive wing of the Brazilian, Latin American and European Catholic church. The CPV played an important role in the organisation and mobilisation of the social movements that emerged in this period and in the fight to redemocratise Brazil. It implemented a broad programme of popular documentation and communication, understood as educational and political practices linked to the struggles and defence of the working class. The CPV adopted the workers struggles of its time and organised an extensive programme to build and strengthen the communication, documentation and recording of the history of social movements. We chose to conduct a wide-ranging study that describes the CPV s experience, its social and political composition, its participation in the extensive communication and documentation networks and its internal practices in developing an innovative experience of popular documentation. It could be considered to be a model of how to organise a popular documentation centre and produce and distribute popular dossiers and booklets / O Centro de Pesquisa e Documentação Vergueiro (CPV) é hoje reconhecido pelo patrimônio documental que acumulou durante os seus quarenta anos de atuação. Esta pesquisa recoloca o foco na experiência histórica que possibilitou a constituição desse patrimônio, evidenciando a atuação política e as concepções e práticas de documentação e comunicação popular implementadas nas décadas de 1970 e 1980 pelo então Centro de Pastoral Vergueiro (CPV). O CPV, fundado por dominicanos da Comunidade Cristo Operário na região sul da cidade de São Paulo, sempre teve uma composição política plural, atuando junto às oposições sindicais, aos movimentos de bairro e a diversos organismos da base e da hierarquia das igrejas progressistas brasileiras, latino-americanas e europeias. Nesse período de grande ascensão dos movimentos sociais, o CPV se destacou na organização e mobilização desses movimentos e também nas lutas pela redemocratização do Brasil, tendo como fio condutor do seu trabalho um amplo projeto de documentação e comunicação popular, entendidas como práticas de caráter formativo e político e vinculadas às lutas e à defesa da classe trabalhadora. O CPV encampou as lutas dos trabalhadores de seu tempo, promovendo um amplo projeto de construção e fortalecimento dos processos de comunicação, documentação e memória dos movimentos sociais. Optamos por um estudo panorâmico que aborda a experiência do CPV, destacando sua composição social e política, a sua participação em grandes redes de comunicação e documentação e suas práticas internas na construção de uma área inovadora de documentação popular, podendo ser considerado exemplo na criação de um método de organização de acervo popular e na produção e distribuição de dossiês e cadernos populares

A presente pesquisa teve por objetivo geral analisar os usos dos termos documentação, documento e objeto no contexto da área de museus. Tal contexto foi caracterizado em dois universos: o teórico, da literatura selecionada de caráter teórico da Documentação, Ciência da Informação e a Museologia, e o prático, composto por duas normas da área de museus. Os objetivos de trabalhar com estes dois universos foram mapear, caracterizar e problematizar ideias, tensões e aproximações entre os universos da teoria e da prática, sem a pretensão de se chegar a uma definição unívoca dos mesmos. Para alcançar tais objetivos, optou-se por uma metodologia exploratória, descritiva, comparativa e que se valeu de elementos de pesquisa histórica. No que se refere aos procedimentos, se realizou essencialmente levantamento bibliográfico e uso de ficha de coleta terminológica para o termo documentação - apenas para sistematizar significados e não para propor uma definição unívoca. A comparação entre os usos dos termos estudados apresentam polissemia e certa ambiguidade e, no que se refere particularmente ao termo documentação, ainda há um discurso que reitera a ideia de sua vinculação com a questão do controle das coleções. Os resultados desta investigação reforçam que a diversidade de significados influencia fortemente o que se realiza na prática profissional. Além disso, os usos consolidam diferentes tradições e formas de se conceber documentação e objetos-documentos nos museus - o que deve ser cada vez mais pesquisado para reforçar laços e rever conceitos e procedimentos. Por último, vale destacar que o propósito deste trabalho foi de explorar as diferenças terminológicas, tão inerentes ao universo dos museus, e colocar questões de como operar com elas e a partir delas. / The present study aimed to analyze the general uses of the terms documentation, document and object within the context of the museums field. This context was characterized in two universes: the theoretical, represented by selected bibliography taken from Documentation, Information Science and Museology, and practical, consisting of two standards of museums area. The objectives of working with these two universes were to map, characterize and discuss ideas, approaches and tensions between the worlds of theory and practice, without the intention of getting any unique definition. In order to get those objectives, an exploratory, descriptive, comparative methodology was chosen, that also drew upon elements of historical research. As regards procedures, bibliographic record and use of terminological data collection form for the term documentation were used, and this last one was only to systematize meanings and not to elaborate a unified definition. The comparison between the uses of the terms being studied point out their polysemy and ambiguity and, in the case of term documentation, the idea of its connection with the control of the collections still remains. Results of this study also reinforce this diversity of meanings strongly influences what is done in professional practice. Furthermore, it consolidates different traditions and ways of conceiving documentation and objects-documents in museums - which should be increasingly researched to reinforce ties and review concepts and procedures. Finally, it is worth noting that the purpose of this study was to explore the terminological differences, so inherent to the universe of museums, and raise the issue of how to deal with them and from them.

L'adolescence constitue une période de construction de soi pendant laquelle tant l'intériorité que le corps physique se transforment. Cette métamorphose change le rapport des jeunes aussi bien au monde, qu'au corps et qu'à la lecture. Leurs pratiques dans ce domaine sont très variées et sont souvent mises en concurrence avec d'autres activités. Certains sont en rupture avec le livre- perçu comme un objet contraignant- alors qu'il est très présent à l'école. Quel rapport l'élève entretient-il avec cet objet ? Quels sont ses pratiques et ses comportements de lecteur ? Inscrite dans une approche bibliologique (Otlet, Estivals) des phénomènes médiateurs et anthropologique des comportements (Lévi-Strauss, Monod) cette recherche à partir de la production de dessins que nous décrivons et analysons grâce aux langages documentaires -d'ordinaire utilisés par les professionnels de l'information-, opère un glissement du portrait du lecteur à la scène de lecture. Porteurs d'indices et de détails signifiants et croisés avec des entretiens, nous interprétons la matière informative recueillie à l'aide d'une grille d'observation et d'interprétation élaborée spécifiquement. Cet outil d'analyse de contenu, construit à partir d'un lexique spécifique lié à la pratique observée, permet de traduire le langage graphique en mots. Le dessin, comme méthode visuelle et sensible, révèle des pratiques, des postures, des attitudes, des comportements, des rituels de lecture et des ressentis. Ainsi, en montrant des sujets agissants et couplé à d'autres méthodes d'investigation, le dessin nous paraît apte à révéler une conscience de soi lecteur et à assurer la médiation entre ce dernier et le livre. / The teen years is a self-construction period : inner character and physical body are transformed. For the teenagers, this metamorphosis modifies their relationship to the world, their body and also their reading choises. In the field of reading, their practices are very different, frequently in competition with others activities. Some teenagers have broken away from the book sensed as a limiting object, despite its presence in the school environment. What kind of relationship exists between the pupils and this object ? What kind of practices and behaviours do they adopt as readers ? In keeping with the biblilogic approach (Otlet, Estivals) of the mediator and that of the anthropological phenomena of behaviours (Lévi-Strauss, Monod), the production of drawings described and analyzed through the indexing language - usually used by the information professionals - is the starting point of this research which undertakes a shift from the portrait of the reader to the reading scene. Whilst bringing significant clues and details alongside interviews, we analysed the collected informative material using an observation and interpretation table that we have specifically developed. This analysis tool constructed from specific lexicon linked with the observed practice is a way to translate the graphic language into words. The drawing, considered as a visual and sensitive method, reveals some practices, postures, attitudes, behaviours, reading rituals and perceptions. Finally, showing active subjects and with our approach supplemented by other investigation methods, drawings seems to be able to reveal a self-consciousness as reader and to act as mediator between the latter and the book.

Yra daugybė įvairiausių tipų mokslinių tiriamųjų darbų, vienas iš jų būtų magistro baigiamasis darbas. Šio darbo metu magistrantams reikia atlikti įvairius tyrimus, visapusiškai išnagrinėti savo pasirinktą temą, pasiūlyti problemos sprendimą, atlikti eksperimentą, kurio metu bus nagrinėjamas siūlomo sprendimo efektyvumas. Visus šių tyrimų rezultatus magistrantams reikia aprašyti. Magistro baigiamojo darbo aprašo rengimas studentams yra vienas iš sudėtingesnių uždavinių. Kaip ir visiems moksliniams tiriamiesiems darbams, jiems keliami tam tikri specifiniai reikalavimai. Daugelis studentų su tokio pobūdžio darbu susiduria pirmą kartą. Jiems tenka spręsti ne tik pasirinktos tyrimo srities problemas, bet ir tinkamai aprašyti atliktą tyrimą ir jo sprendimus. Vien bendrųjų metodinių nurodymų darbo aprašo rengimui studentui nepakanka, nes darbo aprašo turinys labai priklauso nuo darbo temos. Kadangi Informacinių sistemų inžinerijos srities temų įvairovė yra labai didelė, studentams yra sunku sudėlioti tinkamą darbo aprašo turinį, remiantis vien bendraisiais metodiniais nurodymais. Pasirinkto magistrinio darbo tikslas yra sudaryti geresnes sąlygas studentui rengti mokslinio tiriamojo darbo aprašą ir gerinti jo kokybę, sukuriant programų sistemą, kuri pasiūlytų aprašo karkasą, keletą šablonų jam užpildyti ir sugeneruotų aprašo eskizą. / There are a lot of research document types, and one of them is the master’s degree research document. When the student is doing his master’s degree document, he has to do a lot of research, search for a problem and provide the solution for that problem. Also he has to do an experiment for his thesis. All of the results and how it was achieved has to be written in the research document. Masters research document preparation is one of the more difficult tasks for the students. Like all of the research papers, there are certain specific requirements for each type. Also the structure depends for which semester the document is prepared for. Most of the students find that this is their first experience writing these kinds of documents. The common structure guidelines for the documents are not enough, because the content of the documents are very tightly linked to the student’s thesis, and its parameters: object, area, problem, solution. Because there are a lot of different theses in the information engineering area, it is hard for the students to create the primary research paper structure and content, only relying on the common guidelines given by the lecturers. Our proposed solution – a system, which would suggest a document structure and generate the research document primary version, provide comments, template phrases for specific sections of the document, e.g. writing the conclusion. Also the system will try to speed up the writing process, by providing with additional tools... [to full text]