Products · Product
YAML
Raised as a usability problem by 168 people on Hacker News over 15 years (2012–2026), in 106 threads.
No issue was raised by at least 3 people in 3 threads this year.
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9Quoting rules are hard to rememberUnreviewed
- 10
- 11
Every issue, all time, most people first
Complicated configurations become hard to manage with string formattingUnreviewed
20122026- Brain finds YAML hard to parse, making config files hard to read2026-05-23
- Scripting bolted onto YAML makes it annoying, with every team's approach different2026-03-15
- YAML is awkward for programmers and worse for non-programmers2025-04-08
Whitespace-sensitive syntax is hard to write and maintainUnreviewed
20122026- Significant whitespace makes config break unexpectedly with small indentation changes2026-01-12
- Whitespace-sensitive syntax makes long documents easy to get lost in and hard to edit2025-06-20
- Whitespace and missing dashes cause hours of silent debugging2024-03-11
Indentation errors are nearly invisible and hard to debugUnreviewed
20122026- Constantly gets indentation wrong with no tooling to catch errors2026-01-02
- Indentation errors at document end are reported on line 2 with lost context2024-02-08
- Indentation errors are invisible in large files and can't be auto-formatted or detected2022-08-08
Unquoted values silently take unexpected types, hiding resultsUnreviewed
20122026- Unquoted values like NO silently become booleans, causing accidental mistyping2024-01-23
- Unquoted numeric-looking strings get parsed as other types, so people commit errors2023-09-21
- Unquoted values like 'no' or 22:22 are silently converted to unexpected types2023-01-12
Config formats turn into messy mixes of config and codeUnreviewed
20122026- Config formats evolve into messy mixes of config and code, hard to work with2026-10-18
- Config files get confusing: unclear where a new option belongs in nested structure2023-09-14
- Whitespace and overly broad syntax make configs feel like a minefield and break builds2021-11-14
Templated YAML is cumbersome, forcing a separate toolUnreviewed
20122026- Tinkering with many YAML files to provision a Kafka topic is tedious; YAML is hard to structure, search and template2024-02-29
- Templated YAML is cumbersome to work with, prompting the author to build a separate tool2023-09-28
- Templated YAML DSLs have many footguns and are hard to debug2023-07-16
Deep nesting makes indentation-based structure hard to readUnreviewed
20122026- Nested structures and indentation are unclear, so files are hard to read and write without errors2025-03-27
- Meaningful indentation and deep nesting make it hard to read and write2023-09-28
- Nested list versus sibling indentation differences are not obvious, causing easy mistakes when pasting2018-02-06
Inconsistent syntax is hard to understandUnreviewed
20122026- Inconsistent syntax makes it much harder for people to understand2023-08-30
- Syntax is error-prone, a foot gun that's easy to get wrong2022-05-24
- Too many weird syntax shortcuts make it hard to tell what's going on2020-03-11
Quoting rules are hard to rememberUnreviewed
20122026- Whitespace-sensitive indentation and quoted vs unquoted strings behave confusingly, making it hard to work with2025-02-24
- Must remember to quote strings to avoid unintended typing, a source of errors2020-10-03
- Syntax is weird and unintuitive; hard to remember quoting rules2018-06-20
Easy to lose track of the current indentation levelUnreviewed
20122026- Significant indentation is easy to mess up and makes context hard to identify2025-10-12
- Hard to tell indentation levels and whether a line is a new entry2024-01-23
- Easy to forget which indentation level you're currently at2020-09-29
Too many ways to write multiline strings confuse the formatUnreviewed
20122026- Multi-line string processing modes are confusing to choose between2023-09-28
- Too many multi-line string options and confusing folding rules2023-01-12
- Too many ways to write multiline strings, making the format unintuitive2021-11-22
Unreviewed issues were grouped by machine: Claude Haiku labelled each comment as a usability complaint, named what it's about and summed up the problem in a line, and a small model grouped similar problems. Nobody has checked them by hand. Expect mistakes.
The newest 50 complaints
- Config formats evolve into messy mixes of config and code, hard to work with2026-10-18
- Strict indentation and ambiguous dash placement in arrays cause constant confusion and errors2026-09-03
- Making a value a list has nonsensical expectations, so the user can't work out how to write it2026-08-17
- Brain finds YAML hard to parse, making config files hard to read2026-05-23
- Scripting bolted onto YAML makes it annoying, with every team's approach different2026-03-15
- Minor changes unexpectedly break everything, hard to debug2026-03-14
- Significant whitespace makes config break unexpectedly with small indentation changes2026-01-12
- Constantly gets indentation wrong with no tooling to catch errors2026-01-02
- Obscure features trip up users who keep configs simple2025-11-17
- Significant indentation is easy to mess up and makes context hard to identify2025-10-12
- Unquoted 22:22 is parsed as a number, which is counter-intuitive to the writer2025-09-23
- Hard to visually tell where blocks end in YAML2025-09-22
- Correct-looking inputs silently produce unexpected outputs, forcing users to learn hidden rules2025-06-20
- Whitespace-sensitive syntax makes long documents easy to get lost in and hard to edit2025-06-20
- YAML is awkward for programmers and worse for non-programmers2025-04-08
- Nested structures and indentation are unclear, so files are hard to read and write without errors2025-03-27
- Whitespace-sensitive indentation and quoted vs unquoted strings behave confusingly, making it hard to work with2025-02-24
- Editing YAML config by copy-pasting is tedious and error-prone2024-12-20
- Block-style YAML is hard to read; can't tell objects from arrays without effort2024-12-09
- Hard to tell objects from arrays at a glance in large files2024-12-08
- YAML's anchors for avoiding repetition are obscure and hard to use2024-10-27
- Indentation-sensitive syntax is restrictive and forces learning the designer's specific mental model2024-06-02
- Docs list settings but don't explain how to handle complex YAML data or combine options2024-05-05
- Multi-line values in YAML are confusing enough to need a dedicated help site2024-05-05
- Editing YAML is awful, with whitespace and formatting details making orchestration design hard2024-04-05
- Whitespace and missing dashes cause hours of silent debugging2024-03-11
- YAML becomes hard to manage for complicated configurations, especially with string formatting2024-03-03
- Tinkering with many YAML files to provision a Kafka topic is tedious; YAML is hard to structure, search and template2024-02-29
- Libraries don't support YAML anchors, so users must hand-parse indentation to resolve them2024-02-21
- Indentation errors at document end are reported on line 2 with lost context2024-02-08
- Copy, paste and indent in editors often land somewhere unexpected2024-02-04
- Must repeat near-identical config blocks, changing only a few values, and keep them in sync2024-02-03
- YAML configuration makes the user's work frustrating, and feedback is slow in build systems2024-02-03
- Whitespace-sensitive syntax and multiple boolean spellings make it error-prone2024-01-23
- Hard to tell indentation levels and whether a line is a new entry2024-01-23
- Hard to find errors like a missing space or tab in long files2024-01-23
- Unquoted values like NO silently become booleans, causing accidental mistyping2024-01-23
- Looks human-friendly but syntax must be exact, and nesting is hard to follow2024-01-23
- YAML in CI/CD becomes verbose, unintuitive and vendor-specific, hard to work with2024-01-23
- Long YAML documents make it easy to lose context and misindent2024-01-23
- Must push config many times to get CI pipelines working; can't test locally2023-11-21
- Whitespace and quoting mistakes produce unhelpful errors, making YAML hard to write2023-11-08
- YAML has nasty gotchas that make it painful to use for configuration2023-10-04
- Templated YAML is cumbersome to work with, prompting the author to build a separate tool2023-09-28
- Multi-line string processing modes are confusing to choose between2023-09-28
- Hard to tell which parent a bullet or key belongs to in long files2023-09-28
- Extremely unintuitive at first glance and really easy to break2023-09-28
- No validation or error feedback; typos silently ignored, so you can't tell why it fails2023-09-28
- Meaningful indentation and deep nesting make it hard to read and write2023-09-28
- Still struggles to fully understand some YAML syntax after long use2023-09-21