Um estudo sobre a qualidade da documentação em frameworks javascript populares e seu impacto no desenvolvimento de aplicações web e na aprendizagem de desenvolvedores
Um estudo sobre a qualidade da documentação em frameworks javascript populares e seu impacto no desenvolvimento de aplicações web e na aprendizagem de desenvolvedores
<junior.silva@arapiraca.ufal.br>
A crescente demanda por tecnologia, aliada ao aumento na utilização de aplicações web, tem impulsionado o uso de frameworks devido à sua praticidade e dinamismo no desenvolvimento. Estas ferramentas são acompanhadas de documentações que orientam os desenvolvedores em seu uso. Este estudo avalia a completude das documentações dos frameworks front-end JavaScript populares – React, Angular e Vue.js – e seus impactos como ferramentas de apoio durante o desenvolvimento e na curva de aprendizado. Para isso, foi realizada uma análise quantitativa e qualitativa através de um questionário online com 28 desenvolvedores web e uma análise de inspeção na documentação do Angular. Os participantes avaliaram as documentações em aspectos como abrangência, organização, clareza, atualização, suporte, exemplos e tutoriais, utilizando uma escala Likert. Os resultados reforçam a importância de documentações bem estruturadas e atualizadas, evidenciando sua influência direta no aprendizado de novas funcionalidades e na resolução de questões técnicas específicas. Este estudo contribui para o entendimento do papel estratégico das documentações oficiais e oferece insights relevantes para aprimorar a experiência de desenvolvimento com frameworks front-end.
The growing demand for technology, combined with the increase in the use of web applications, has boosted the use of frameworks due to their practicality and dynamism in development. These tools are accompanied by documentation that guides developers in their use. This study evaluates the completeness of the documentation for the popular JavaScript front-end frameworks - React, Angular and Vue.js - and their impact as support tools during development and on the learning curve. To do this, a quantitative and qualitative analysis was carried out using an online questionnaire with 28 web developers and an inspection analysis of the Angular documentation. Participants evaluated the documentation on aspects such as comprehensiveness, organization, clarity, updating, support, examples and tutorials, using a Likert scale. The results reinforce the importance of well-structured and up-to-date documentation, highlighting its direct influence on learning new features and resolving specific technical issues. This study contributes to the understanding of the strategic role of official documentation and offers relevant insights for improving the development experience with front-end frameworks.
Ma. Barbosa, Jessica Fernanda Silva.
Documentação de framework.
Qualidade de documentação.
Frameworks front-end.