МЕТОДИ ПІДВИЩЕННЯ ЕФЕКТИВНОСТІ АВТОМАТИЗАЦІЇ ДОКУМЕНТУВАННЯ ПРОГРАМНИХ ПРОДУКТІВ НА ОСНОВІ СТАТИЧНОГО АНАЛІЗУ КОДУ
DOI:
https://doi.org/10.36074/grail-of-science.15.05.2026.112Keywords:
автоматизація документування, статичний аналіз коду, абстрактне синтаксичне дерево, JavaScript, Node.js, ефективність розробкиSummary
Досліджено сучасні методи підвищення ефективності автоматизації документування програмних продуктів із використанням технологій статичного аналізу коду. Проаналізовано існуючі підходи, зокрема екстракцію даних із коментарів (inline documentation), API-орієнтоване документування, концепцію «документація як код» та методи на основі штучного інтелекту. Визначено переваги, обмеження та сферу застосування в умовах сучасних методологій розробки програмного забезпечення (Agile, DevOps). Запропоновано формалізовану логіко-математичну модель трансформації вихідного коду у структуровані знання, що базується на використанні оператора перетворення та метрик оцінювання якості документації, зокрема коефіцієнта повноти покриття та ступеня семантичної відповідності. Розроблено програмний прототип системи автоматизованого документування на платформі Node.js із використанням аналізу абстрактних синтаксичних дерев (AST) відповідно до стандарту ESTree. Реалізовано модульну архітектуру, що включає компоненти пошуку файлів, синтаксичного аналізу, трансформації даних та генерації документації у форматі Markdown. Особливу увагу приділено обробці складних структур JavaScript, зокрема класів, асинхронних функцій та модульної організації коду. Експериментально підтверджено високу ефективність запропонованого підходу: забезпечено 100% покриття технічних сигнатур та досягнуто скорочення часу на документування на 85–90% порівняно з традиційними методами.
Downloads
Downloads
References
Brooks F. P. Jr. The Mythical Man-Month: Essays on Software Engineering. Addison-Wesley, 1995.
Sommerville I. SOFTWARE ENGINEERING. 10th ed. Pearson, 2015.
Martin R. C. Clean Code: A Handbook of Agile Software Craftsmanship. Prentice Hall, 2008.
OpenAPI Specification v3.1.0., https://spec.openapis.org/oas/v3.1.0
Node.js v20.x Documentation., https://nodejs.org/docs/
ESTree Specification. GitHub Repository., URL: https://github.com/estree/estree
Haverbeke M. Acorn: A tiny, fast JavaScript-based JavaScript parser., https://github.com/acornjs/acorn
JSON Schema Specification., https://json-schema.org/
Official JSDoc Documentation., https://jsdoc.app/
Fowler M. Refactoring: Improving the Design of Existing Code. Addison-Wesley, 2018.
Downloads
How to Cite
Issue
Section
Categories