Reading Between the Curly Braces: On Textual Data Serialization Format Usability
arXiv:2607.26211
The paper investigates how different textual data serialization formats (e.g., JSON, YAML, HJSON) affect user usability, finding that syntax differences matter less than surrounding tools, documentation, and community support.
Abstract
Textual data serialization formats, such as JSON or XML, are ubiquitous, supporting tasks like software configuration and data tabularization. Despite their prominence, little is known about their usability. What makes one good or bad? Is there a best one for cognitive efficiency? We explore these questions via a (N=215) crowd work study and a (N=9) semi-structured interview study. We find that format distinctions (like indentation versus curly braces) do not consistently translate into substantial usability differences. While HJSON and YAML performed better than other formats in certain modification tasks, these advantages disappeared in more realistic settings where task complexity was either trivial or highly demanding. Instead, usability appears driven by sociotechnical ecosystems: the tooling, documentation, and community practices surrounding a format matter more than syntax.