"Working with JSON Data" in "Getting Started" Section of Documentation

[mickey-vershbow]

I think it would be great if the Apex docs included a "Working with JSON Data" section much earlier on in the docs. I'm aware this exists in the "how to" section, but for a dev who already has a code pattern in mind for working with JSON data, it is not clear from the intro section of the docs that a specific pattern must be followed in order for charts to update with new data properly. This way new users could understand from the start that if they are trying to work with dynamically updating data, they will need to generate an empty chart, and then get the data, and then update the chart using "updateSeries" and "updateOptions" methods. This is not made clear anywhere in the docs unless you are specifically looking for those methods. I myself had the experience of creating the chart in a more straightforward way -- grabbing the data, and then passing it to a function that generates the chart, using callbacks to make sure updated data is loaded first -- and then had to refactor completely.