From b4a125877fc0876890be4ac8e3877a5eaa57850f Mon Sep 17 00:00:00 2001 From: Michael Neth Date: Thu, 15 Oct 2015 15:21:52 -0500 Subject: Clarified some of the intro text Clarified the terminology of a "JSON value" and its limited set of options. Clarified that Supporting Browsers are from the shown version and up. Clarified that ".json" is the standard "file extension". --- json.html.markdown | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) (limited to 'json.html.markdown') diff --git a/json.html.markdown b/json.html.markdown index 060e9c3d..260221bf 100644 --- a/json.html.markdown +++ b/json.html.markdown @@ -17,9 +17,11 @@ but they should be avoided for better compatibility. For the purposes of this, however, everything is going to be 100% valid JSON. Luckily, it kind of speaks for itself. -Data types supported by JSON includes: numbers, string, boolean, array, object and null. -Supporting browsers are: Firefox(Mozilla) 3.5, Internet Explorer 8, Chrome, Opera 10, Safari 4. -JSON file type for JSON files is ".json". The MIME type for JSON text is "application/json" +A JSON value must be a number, a string, an array, an object, or one of the following 3 literal names: true, false, null. + +Supporting browsers are: Firefox 3.5+, Internet Explorer 8+, Chrome, Opera 10+, and Safari 4+. +File extension for JSON files is ".json" and the MIME type for JSON text is "application/json". + Drawbacks of JSON include lack of type definition and some sort of DTD. ```json -- cgit v1.2.3 From 56d0c93fd94f7ab9a6d2ee238dd6ef62d5f2a13e Mon Sep 17 00:00:00 2001 From: Michael Neth Date: Thu, 15 Oct 2015 15:25:26 -0500 Subject: Remove "drawbacks" sentence Opinionated information probably shouldn't end up in one of these, especially when it is non-comprehensive and does not include any of the "pro" arguments. --- json.html.markdown | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) (limited to 'json.html.markdown') diff --git a/json.html.markdown b/json.html.markdown index 260221bf..ec802b33 100644 --- a/json.html.markdown +++ b/json.html.markdown @@ -20,9 +20,8 @@ For the purposes of this, however, everything is going to be 100% valid JSON. Lu A JSON value must be a number, a string, an array, an object, or one of the following 3 literal names: true, false, null. Supporting browsers are: Firefox 3.5+, Internet Explorer 8+, Chrome, Opera 10+, and Safari 4+. -File extension for JSON files is ".json" and the MIME type for JSON text is "application/json". -Drawbacks of JSON include lack of type definition and some sort of DTD. +File extension for JSON files is ".json" and the MIME type for JSON text is "application/json". ```json { -- cgit v1.2.3 From e951f409a0642e713e53b202545e928ffb15b676 Mon Sep 17 00:00:00 2001 From: Michael Neth Date: Thu, 15 Oct 2015 15:30:21 -0500 Subject: Added some more information about valid JSON A single array can also be valid JSON. Removed the "And, you're done. You now know everything JSON has to offer." value since I added additional information after it. --- json.html.markdown | 30 ++++++++++++++++++++---------- 1 file changed, 20 insertions(+), 10 deletions(-) (limited to 'json.html.markdown') diff --git a/json.html.markdown b/json.html.markdown index ec802b33..5354b997 100644 --- a/json.html.markdown +++ b/json.html.markdown @@ -7,22 +7,22 @@ contributors: - ["himanshu", "https://github.com/himanshu81494"] --- -As JSON is an extremely simple data-interchange format, this is most likely going -to be the simplest Learn X in Y Minutes ever. +As JSON is an extremely simple data-interchange format, this is most likely going to be the simplest Learn X in Y Minutes ever. -JSON in its purest form has no actual comments, but most parsers will accept -C-style (`//`, `/* */`) comments. Some parsers also tolerate a trailing comma -(i.e. a comma after the last element of an array or the after the last property of an object), -but they should be avoided for better compatibility. +JSON in its purest form has no actual comments, but most parsers will accept C-style (`//`, `/* */`) comments. Some parsers also tolerate a trailing comma (i.e. a comma after the last element of an array or the after the last property of an object), but they should be avoided for better compatibility. For the purposes of this, however, everything is going to be 100% valid JSON. Luckily, it kind of speaks for itself. A JSON value must be a number, a string, an array, an object, or one of the following 3 literal names: true, false, null. -Supporting browsers are: Firefox 3.5+, Internet Explorer 8+, Chrome, Opera 10+, and Safari 4+. +Supporting browsers are: Firefox 3.5+, Internet Explorer 8.0+, Chrome 1.0+, Opera 10.0+, and Safari 4.0+. File extension for JSON files is ".json" and the MIME type for JSON text is "application/json". +JSON is built on two structures: +* A collection of name/value pairs. In various languages, this is realized as an object, record, struct, dictionary, hash table, keyed list, or associative array. +* An ordered list of values. In most languages, this is realized as an array, vector, list, or sequence. + ```json { "key": "value", @@ -61,8 +61,18 @@ File extension for JSON files is ".json" and the MIME type for JSON text is "app "comment": "check this out!" , "comma position": "doesn't matter - as long as it's before the next key, then it's valid" , "another comment": "how nice" - }, - - "that was short": "And, you're done. You now know everything JSON has to offer." + } } ``` + +A single array of values by itself is also valid JSON. + +```json +[1, 2, 3, "text", true] +``` + +Objects can be a part of the array as well. + +```json +[{"name": "Bob", "age": 25}, {"name": "Jane", "age": 29}, {"name": "Jack", "age": 31}] +``` -- cgit v1.2.3 From af1465d02f8c44fe5a803c058a6ea55219dfe997 Mon Sep 17 00:00:00 2001 From: Michael Neth Date: Thu, 15 Oct 2015 15:30:59 -0500 Subject: Added my contributor information --- json.html.markdown | 1 + 1 file changed, 1 insertion(+) (limited to 'json.html.markdown') diff --git a/json.html.markdown b/json.html.markdown index 5354b997..140aa366 100644 --- a/json.html.markdown +++ b/json.html.markdown @@ -5,6 +5,7 @@ contributors: - ["Anna Harren", "https://github.com/iirelu"] - ["Marco Scannadinari", "https://github.com/marcoms"] - ["himanshu", "https://github.com/himanshu81494"] + - ["Michael Neth", "https://github.com/infernocloud"] --- As JSON is an extremely simple data-interchange format, this is most likely going to be the simplest Learn X in Y Minutes ever. -- cgit v1.2.3 From 76b8a3a36eb0b339c39d545ff186294ba7eb7ecc Mon Sep 17 00:00:00 2001 From: Michael Neth Date: Thu, 15 Oct 2015 15:35:13 -0500 Subject: Added a more info link and extra explanation Added link to json.org Included information about using JSON text as data. --- json.html.markdown | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'json.html.markdown') diff --git a/json.html.markdown b/json.html.markdown index 140aa366..cde7bc40 100644 --- a/json.html.markdown +++ b/json.html.markdown @@ -20,10 +20,16 @@ Supporting browsers are: Firefox 3.5+, Internet Explorer 8.0+, Chrome 1.0+, Oper File extension for JSON files is ".json" and the MIME type for JSON text is "application/json". +Many programming languages have support for serializing (encoding) and unserializing (decoding) JSON data into native data structures. Javascript has implicit support for manipulating JSON text as data. + +More information can be found at http://www.json.org/ + JSON is built on two structures: * A collection of name/value pairs. In various languages, this is realized as an object, record, struct, dictionary, hash table, keyed list, or associative array. * An ordered list of values. In most languages, this is realized as an array, vector, list, or sequence. +An object with various name/value pairs. + ```json { "key": "value", -- cgit v1.2.3