Socio-Technical Smell Dynamics in Code Samples: A Multivocal Review on Emergence, Evolution, and Co-Occurrence

2025-07-17

AI Summary

This study investigates the co-occurrence and evolutionary relationship between technical code smells (e.g., large classes, low modularity) and socio-technical community smells (e.g., contributor isolation, fragmented communication) in open-source teaching code, examining how community dysfunction presages and exacerbates code quality degradation. Using a multi-vocal literature review, we systematically analyze 30 academic papers and 17 practitioner artifacts, identifying— for the first time—nine empirically grounded socio-technical smell patterns. Results show that community smells (e.g., “silent communication,” maintenance centralization) frequently precede or amplify technical deterioration; insufficient continuous refactoring and inadequate onboarding of newcomers are key drivers of smell accumulation. Based on these findings, we propose a lightweight, collaborative governance mechanism tailored to educational codebases. This work advances both theoretical understanding and practical strategies for enhancing the sustainability and maintainability of open-source teaching code.

Technology Category

• Data Mining & Knowledge Management: Graph Mining, Social Network Analysis & Community
• Cognitive Modeling & Cognitive Systems: Social Cognition And Interaction
• Search and Optimization: Evolutionary Computation

Application Category

• Social Networks and Social Media: Socio-technical web-based systems
• Responsible Web: Social and technical mechanisms of refusal for web technologies and applications
• Web Mining and Content Analysis: Models for Web evolution

Abstract

Code samples play a pivotal role in open-source ecosystems (OSSECO), serving as lightweight artifacts that support knowledge transfer, onboarding, and framework adoption. Despite their instructional relevance, these samples are often governed informally, with minimal review and unclear ownership, which increases their exposure to socio-technical degradation. In this context, the co-occurrence and longitudinal interplay of code smells (e.g., large classes, poor modularity) and community smells (e.g., lone contributors, fragmented communication) become particularly critical. While each type of smell has been studied in isolation, little is known about how community-level dysfunctions anticipate or exacerbate technical anomalies in code samples over time. This study investigates how code and community smells emerge, co-occur, and evolve within code samples maintained in OSSECOs. A Multivocal Literature Review protocol was applied, encompassing 30 peer-reviewed papers and 17 practitioner-oriented sources (2013-2024). Thematic synthesis was conducted to identify recurring socio-technical patterns related to smell dynamics. Nine patterns were identified, showing that community smells often precede or reinforce technical degradation in code samples. Symptoms such as "radio silence" and centralized ownership were frequently associated with persistent structural anomalies. Additionally, limited onboarding, the absence of continuous refactoring, and informal collaboration emerged as recurring conditions for smell accumulation. Conclusion: In OSSECOs, particularly within code samples, community-level dysfunctions not only correlate with but often signal maintainability decay. These findings underscore the need for socio-technical quality indicators and lightweight governance mechanisms tailored to shared instructional artifacts.

Problem

• Investigates co-occurrence of code and community smells in OSS
• Explores how community dysfunctions predict technical degradation
• Identifies socio-technical patterns causing smell accumulation in code samples

Innovation

• Multivocal Literature Review protocol applied
• Thematic synthesis identifies socio-technical patterns
• Lightweight governance for shared instructional artifacts