Проектный репозиторий как инструмент образовательной деятельности

Несмотря на использование автоматической генерации текста языковыми моделями навыки технического письма, документирования и обоснования технических решений всегда будут актуальны. Но эволюция разработки программного обеспечения, обусловленная распространением агентных систем, требует поиска новых образовательных активностей, которые бы стимулировали студентов к самостоятельной работе. Производственные практики показывают, что проектный репозиторий структурируется и содержит артефакты, которые документируют программный проект. Поэтому целью данной статьи является предложение способов ведения репозитория программного кода в образовательном процессе подготовки ИТ-специалистов.
В работе представлен анализ отечественных стандартов по программной инженерии, современных практик управления быстрой разработкой ПО и проектами с открытым исходным кодом для определения оптимальной структуры репозитория и документирующих его артефактов с точки зрения управления технологическим процессом разработки ПО, командной работы и получения профессиональных навыков.
Проведенный анализ позволяет предложить использование правильно оформленного репозитория программного кода. Показаны примеры составления стандартных задач по созданию артефактов сопровождения разработки программного продукта, а также шаблоны для составления технического задания, архитектурных спецификаций и пользовательской документации, которые позволяют студентам сформировать навыки обоснования технических решений, представления программного продукта, систематизировать знания технологии разработки, получить опыт работы с разнообразными инструментальными средствами.
Предложенные практики включены в преподавание дисциплин «Программная инженерия» и «Технология программного обеспечения» и успешно используются в проектной деятельности в рамках образовательного процесса Воронежского государственного технического университета. Описан опыт использования каталога студенческих проектов для формирования профессиональных навыков программиста и специалиста по информационным технологиям.
На основании этих результатов сформулированы рекомендации для повышения качества образовательного процесса по дисциплинам профессионального цикла направления «Информационные системы и технологии».

1. Zhuoyan Li, Chen Liang, Jing Peng, Ming Yin. The value, benefits, and concerns of generative AI-powered assistance in writing. CHI ‘24: Proc. 2024 CHI Conf. on Human Factors in Computing Systems. 2024;(1048):1–25. DOI: 10.1145/3613904.3642625.

2. Ярошенко Г. В., Савушкин И. А. Социальные последствия применения систем искусственного интеллекта в образовании. Государственное и муниципальное управление. Ученые записки. 2023;(3):278–284. DOI: 10.22394/2079-1690-2023-1-3-278-284. EDN: QWUVMZ.

3. Gamil Y., Alhajlah H., Kassem M. A. Automated project progress monitoring in construction projects: A review of current applications and trends. In: Al-Sharafi M. A., AlEmran M., Al-Kabi M. N., Shaalan K. (eds) Proc. 2nd Int. Conf. on Emerging Technologies and Intelligent Systems. ICETIS 2022. Lecture Notes in Networks and Systems. Cham, Springer, 2023;584:274–293. DOI: 10.1007/978-3-031-25274-7_23.

4. Raus T. Z. M., Yusoff M., Subatira B. Technical report writing in engineering studies. LSP International Journal. 2019;6(2):45–59. DOI: 10.11113/LSPI.V6N2.91.

5. Damian A. L., Dias Canedo E., Sieckenius de Souza C., Conte T. Towards to transfer the directives of communicability to software projects: Qualitative studies. Journal of Software Engineering Research and Development. 2021;9:13. DOI: 10.5753/jserd.2021.1942.

6. Ferry D. 77 sure-fire ways to kill a software project: Destructive tactics that cause budget overruns, late deliveries, and massive personnel turnover. San Jose, Authors Choice Press; 2000. 108 p.

7. Havelund K., Tegeler T., Smyth S., Steffen B. Discussing the future role of documentation in the context of modern software engineering. In: Margaria T., Steffen B. (eds) Leveraging Applications of Formal Methods, Verification and Validation. Software Engineering. ISoLA 2022. Lecture Notes in Computer Science. Cham, Springer; 2022;13702:3–9. DOI: 10.1007/978-3-031-19756-7_1.

8. Cico O., Letizia J., Nguyen-Duc A., Zhang H. Exploring the intersection between software industry and software engineering education: A systematic mapping of software engineering trends. Journal of Systems and Software. 2021;172:110736. DOI: 10.1016/j.jss.2020.110736.

9. Borsato M., Peruzzini M. Collaborative engineering. In: Stjepandić J., Wognum N., J. C. Verhagen W. (eds) Concurrent Engineering in the 21st Century. Cham, Springer; 2015:165–196. DOI: 10.1007/978-3-319-13776-6_7.

10. Quetzalli A. Docs-as-ecosystem: The community approach to engineering documentation. Berkeley, Apress; 2023. 242 p. DOI: 10.1007/978-1-4842-9328-7.

11. Sablis A., Smite D., Moe N. Team-external coordination in large-scale software development projects. Journal of Software: Evolution and Process. 2021;33(3):e2297. DOI: 10.1002/smr.2297.

12. Broy M. Software system documentation: Coherent description of software system properties. In: Margaria T., Steffen B. (eds) Leveraging Applications of Formal Methods, Verification and Validation. Software Engineering. ISoLA 2022. Lecture Notes in Computer Science. Cham, Springer; 2022:10–27. DOI: 10.1007/978-3-031-19756-7_2.

13. Aghajani E., Nagy C., Vega-Márquez O. L., Linares-Vásquez M., Moreno L., Bavota G. Software documentation issues unveiled. ACM 41st Int. Conf. on Software Engineering (ICSE). IEEE; 2019:1199–1210. DOI: 10.1109/ICSE.2019.00122.

14. Khlif W., Kchaou D., Bouassida N. A complete traceability methodology between UML diagrams and source code based on enriched use case textual description. Informatica. 2022;46(1):27–47. DOI: 10.31449/inf.v46i1.3306.

15. Herrington D., Beery P., Giammarco K. Assessing design repository search effectiveness. Systems. 2022;10(5):178. DOI: 10.3390/systems10050178.

16. Файзрахманов Р. А., Полевщиков И. С., Боброва И. А. Совершенствование процесса профессиональной подготовки разработчиков программной документации на основе автоматизированной оценки качества формирования навыков. Планирование и обеспечение подготовки кадров для промышленно-экономического комплекса региона. 2019;1:21–25. EDN: DXGSRO.

17. Naseef M. N. M., Nifthas A. R. M., Kapilan K. Analyzing the impact of code smells on software maintainability. Authorea Advance. 2023;(1):1–6. DOI: 10.22541/au.168552004.43700626/v1.

18. Wagenaar G., Overbeek S., Lucassen G., Brinkkemper S., Schneider K. Working software over comprehensive documentation — Rationales of Agile teams for artefacts usage. Journal of Software Engineering Research and Development. 2018;6:Art.7. DOI: 10.1186/s40411-018-0051-7.

19. Васильева Н. В. Открытое программное обеспечение для организации репозитория. Научные и технические библиотеки. 2023;(3):102–119. DOI: 10.33186/1027-3689-2023-3-102-119. EDN: WRBPBW.

20. Wachs J., Nitecki M., Schueller W., Polleres A. The geography of open source software: Evidence from GitHub. Technological Forecasting and Social Change. 2022;176:1-17. DOI: 10.1016/j.techfore.2022.121478.

21. Белладжио Д., Миллиган Т. Разработка программного обеспечения: управление изменениями. М.: ДМК Пресс; 2016. 386 с.

22. Xiao T., Hata H., Treude C., Matsumoto K. Generative AI for pull request descriptions: Adoption, impact, and developer interventions. Proc. ACM on Software Engineering. NYC, ACM; 2024;1(FSE(47)):1043–1065. DOI: 10.1145/3643773.

23. Kilamo T., Hammouda I., Mikkonen T., Aaltonen T. From proprietary to open source — growing an open source ecosystem. Journal of Systems and Software. 2012;85(7):1467–1478. DOI: 10.1016/j.jss.2011.06.071.

24. Sommerville I. Engineering software products. London, Pearson; 2020. 352 p.

25. Islam M. A., Hasan R., Eisty N. U. Documentation practices in agile software development: A systematic literature review. ACIS 21st Int. Conf. on Software Engineering Research, Management and Applications (SERA). IEEE; 2023:266–273. DOI: 10.1109/SERA57763.2023.10197828.

26. Минакова О. В. Программная инженерия. Основные принципы, методы и инструменты: учебник для вузов. Санкт-Петербург: Лань; 2024. 212 с.