EDITOR MARKDOWN PARA DOCUMENTAÇÃO DO DESENVOLVEDOR NA PLATAFORMA LEARNINGCURVE

PABLO MARTINS BORGES

Apresentador(es): PABLO MARTINS BORGES

Orientador(es): PAULO SERGIO MEDEIROS DOS SANTOS, JOBSON LUIZ MASSOLLAR DA SILVA


Área temática: INFORMÁTICA

Modalidade de apresentação: SESSÃO ORAL

Bolsa: PIBIC


Resumo

Na última década, a expansão do setor de Tecnologia da Informação criou diversas oportunidades para o mercado de desenvolvimento de software. Nesse ambiente de contínua evolução e competitividade, os desenvolvedores precisam se manter em constante aprendizado para acompanharem novas tecnologias e atualizações das já existentes. Nesse cenário, a documentação técnica se estabelece como recurso fundamental, exercendo função dupla: auxiliar o processo de desenvolvimento e servir como ferramenta importante para a aprendizagem acadêmica e profissional. No entanto, o uso dessas documentações técnicas traz desafios em termos de acessibilidade, clareza e utilidade no processo de formação. Por exemplo, uma documentação obscura ou confusa pode levar o desenvolvedor ao uso equivocado da tecnologia ou demandar muito tempo para que seja compreendida. Isso motiva a ideia de desenvolver uma plataforma que apoie a elaboração e exibição de documentações técnicas de maneira clara, estruturada e compatível com um modelo de aprendizagem eficaz. O objetivo geral desta pesquisa é desenvolver uma plataforma online para criação e apresentação de documentações técnicas, permitindo que aprendentes tenham acesso a conteúdos estruturados e que desenvolvedores documentem suas ferramentas de maneira eficaz. Especificamente, busca-se criar um ambiente colaborativo que permita a elaboração e visualização das documentações e a interação dos usuários com esse conteúdo por meio de sistemas de avaliação e comentários. A arquitetura adotada para a solução (Figura 1), consiste na divisão do projeto em cinco módulos: (i) uma interface web desenvolvida em Angular para exibição dos conteúdos; (ii) uma API em Java Spring para persistência das informações e aplicação das regras de negócio; (iii) uma extensão do Visual Studio Code, em TypeScript, para edição e compilação de arquivos em LCML (Correia, 2024); (iv) um compilador em Java, responsável pela compilação dos arquivos LCML em HTML; e (v) um servidor LSP que permite a comunicação da extensão do VSCode com o compilador. Os resultados alcançados com a implementação da interface web (Figuras 2 e 3) indicam um sistema intuitivo e acessível, construído segundo modernos padrões de design de interface, permitindo a organização da documentação técnica em conceitos, fatos de execução e padrões de uso. A disponibilização de mecanismos de interação entre quem cria a documentação e quem a utiliza promove um ambiente dinâmico de feedbacks e colaboração que contribui para a melhoria contínua dessas documentações. De forma geral, a construção da plataforma LearningCurve representa um avanço significativo na consolidação de um sistema colaborativo de aprendizagem, e espera-se que sua evolução possibilite a oferta de um ambiente estruturado, interativo e eficiente para o desenvolvimento das habilidades de aprendentes e profissionais da área de Tecnologia da Informação.

Bibliografia

CORREIA, L. C. “Uma linguagem para descrição de conteúdos de trilhas de aprendizagem com aplicação ao ensino de computação”, Trabalho de conclusão de curso - Bacharelado em Sistemas de Informação, UNIRIO, 2024.

Palavras-chave

Documentação técnica Plataforma colaborativa Aprendizagem em TI Desenvolvimento de software LearningCurve
Baixar Material Suplementar (PDF)
Voltar