Add YAML Is A Superset Of JSON as a YAML til

README.md

@@ -10,7 +10,7 @@ pairing with smart people at Hashrocket.
 
 For a steady stream of TILs, [sign up for my newsletter](https://tinyletter.com/jbranchaud).
 
-_1146 TILs and counting..._
+_1147 TILs and counting..._
 
 ---
 
@@ -1347,6 +1347,7 @@ _1146 TILs and counting..._
 ### YAML
 
 - [Create Multi-Line Strings Without The Line Breaks](yaml/create-multi-line-strings-without-the-line-breaks.md)
+- [YAML Is A Superset Of JSON](yaml/yaml-is-a-superset-of-json.md)
 
 ## Usage
 

yaml/yaml-is-a-superset-of-json.md

@@ -0,0 +1,39 @@
+# YAML Is A Superset Of JSON
+
+Put another way, JSON is a subset of YAML.
+
+Here is what the YAML spec has to say:
+
+> YAML can therefore be viewed as a natural superset of JSON, offering improved
+> human readability and a more complete information model. This is also the
+> case in practice; every JSON file is also a valid YAML file.
+
+We can _see_ this in practice by using our favorite YAML parse to read a JSON
+file. For me that is Ruby and its built-in YAML library.
+
+First, consider the following JSON file (`data.json`):
+
+```json
+{
+  "data": [
+    "one",
+    "two",
+    "three"
+  ],
+  "number": 22
+}
+```
+
+Now, I'll open up an IRB session (Ruby's interactive REPL) and read it in.
+
+```ruby
+> require 'yaml'
+=> true
+> YAML.load_file('data.json')
+=> {"data"=>["one", "two", "three"], "number"=>22}
+```
+
+It works. And for me, having not considered those two format related, this
+isn't something I would have expected to work.
+
+[source](http://yaml.org/spec/1.2/spec.html#id2759572)