Skip to content

Commit

Permalink
tweak doc: refine description of YAML
Browse files Browse the repository at this point in the history
  • Loading branch information
Ken Kundert authored and Ken Kundert committed Sep 1, 2020
1 parent a3f05f5 commit e30f038
Showing 1 changed file with 8 additions and 7 deletions.
15 changes: 8 additions & 7 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -98,13 +98,14 @@ All of which results in *JSON* being a frustrating format for humans to enter or
read.

*YAML* was to be the human friendly alternative to *JSON*, but things went very
wrong. The authors were too ambitious and tried to support too many data types
and too many formats. To distinguish between all the various types and formats,
a complicated and non-intuitive set of rules developed. *YAML* at first appears
very appealing when used with simple examples, but things quickly become very
complicated. A reaction to this is the use of *YAML* subsets, such as
`StrictYAML <https://hitchdev.com/strictyaml>`_. However, *StrictYAML* tries to
maintain compatibility with *YAML* and so inherits much of its complexity.
wrong at some point. The authors were too ambitious and tried to support too
many data types and too many formats. To distinguish between all the various
types and formats, a complicated and non-intuitive set of rules developed.
*YAML* at first appears very appealing when used with simple examples, but
things quickly become very complicated. A reaction to this is the use of *YAML*
subsets, such as `StrictYAML <https://hitchdev.com/strictyaml>`_. However, the
subsets try to maintain compatibility with *YAML* and so inherits much of its
complexity.

*NestedText* was inspired by *YAML*, but eschews its complexity. It supports
only a limited number of types and has a very simple set of rules that make up
Expand Down

0 comments on commit e30f038

Please sign in to comment.