Document ⎕JSON wrappers

[abrudz]

Page on which the enhancement should be made
https://docs.dyalog.com/20.0/language-reference-guide/system-functions/json/

Describe the enhancement you would like

Codes 2, 3 and 4 are used to identify different forms of datasets.

Describe what they are.

Also fix the documentation for the JS injection which has escaped doublequotes.

[DyalogRichard]

@abrudz - can you elaborate? You quote:

Codes 2, 3 and 4 are used to identify different forms of datasets.

and ask for a description, but that is exactly what follows in the Datasets section below. However, expanding your quote a little:

Code 1 is used to identify JSON values such as null, true and false. Codes 2, 3 and 4 are used to identify different forms of datasets.
,,,
Wrappers for special JSON values
[description]
Datsets
[description]

Whilst what you are asking for is there, it occurs to me:

(1) The leading sentence in isolation is quite descriptive of what code 1 is and rather vague about 2, 3, 4. Is that disjoint the problem? Would something like

Code 1 is used to identify special JSON values and codes 2, 3 and 4 are used to identify different forms of datasets, as described below.

be better?

(2) Would adding "(code 1)" to the "Wrappers for special JSON values" heading, and "(codes 2, 3 and 4)" to the "Datasets" heading help clarify?

[abrudz]

but that is exactly what follows

I thought so too, at first, but where you abbreviate to "[description]", they are actually never described!

I'll add "as described below", and have already added headers (they are currently just bold) with codes.

However, the bulk of the work here is to actually describe what each specific wrapper does, including missing details like subset selection (there's currently no mention of how to get a subset of fields without subsetting records) and how to use an inverted table with character fields as matrices.

[abrudz]

Oh, and the introduction to datasets has examples that are misleading by putting the header before, rather than after, the data.

[DyalogRichard]

Oh, and the introduction to datasets has examples that are misleading by putting the header before, rather than after, the data.

Anything done to fix that will likely also fix https://mantis.dyalog.com/view.php?id=19093

[abrudz]

Indeed. Thank you. I'll make sure to close that when merging.