skip to main content
Primo Search
Search in: Busca Geral

A systematic literature review on the impact of formatting elements on code legibility

Oliveira, Delano ; Santos, Reydne ; Madeiral, Fernanda ; Masuhara, Hidehiko ; Castor, Fernando

The Journal of systems and software, 2023-09, Vol.203, p.111728, Article 111728 [Periódico revisado por pares]

Elsevier Inc

Texto completo disponível

Citações Citado por
  • Título:
    A systematic literature review on the impact of formatting elements on code legibility
  • Autor: Oliveira, Delano ; Santos, Reydne ; Madeiral, Fernanda ; Masuhara, Hidehiko ; Castor, Fernando
  • Assuntos: Code legibility ; Formatting elements ; Program understandability
  • É parte de: The Journal of systems and software, 2023-09, Vol.203, p.111728, Article 111728
  • Descrição: Software programs can be written in different but functionally equivalent ways. Even though previous research has compared specific formatting elements to find out which alternatives affect code legibility, seeing the bigger picture of what makes code more or less legible is challenging. We aim to find which formatting elements have been investigated in empirical studies and which alternatives were found to be more legible for human subjects. We conducted a systematic literature review and identified 15 papers containing human-centric studies that directly compared alternative formatting elements. We analyzed and organized these formatting elements using a card-sorting method. We identified 13 formatting elements (e.g., indentation) and 33 levels of formatting elements (e.g., two-space indentation), which are about formatting styles, spacing, block delimiters, long or complex code lines, and word boundary styles. While some levels were found to be statistically better than other equivalent ones in terms of code legibility, e.g., appropriate use of indentation with blocks, others were not, e.g., formatting layout. For identifier style, we found divergent results, where one study found a significant difference in favor of camel case, while another study found a positive result in favor of snake case. The number of identified papers, some of which are outdated, and the many null and contradictory results emphasize the relative lack of work in this area and underline the importance of more research. There is much to be understood about how formatting elements influence code legibility before the creation of guidelines and automated aids to help developers make their code more legible. •This is a systematic literature review to find the most legible formatting elements.•From a set of 4,914 documents, we found and examined 15 scientific papers.•We identified 13 formatting elements and 33 alternative levels.•Researchers found statistically significant results for 9 formatting elements, but some with divergent results.•Our results highlight that the area is immature and many studies are inconclusive.
  • Editor: Elsevier Inc
  • Idioma: Inglês

Buscando em bases de dados remotas. Favor aguardar.