Thread:Extension talk:TemplateData/Significant changes to " visualised version" to reflect differences between on template page and API delivered objects

I was originally attempting to define a structure for being able to use the JSON data delivered via the API. While doing so, I noticed that there were significant differences between the data delivered and the "visualised version" depicted on this page. There were "errors" (no "title" key in root), discrepancies between the TemplateData structure and what is actually delivered by the API in response to a HTTP get request (two wrapping objects), and areas where the description was not clear upon first read. I have attempted to improve the description on the page in all three areas.

There are two classes of readers to which this page should be catering: A) Editors writing templates who are adding tags to their template page, and B) developers of software who will use the API to obtain information about templates. Unfortunately, the two data structures seen by these two classes of readers are not identical. I have documented the differences, and provide improved descriptions in some areas which were already documented.

The page is now attempting to provide information to both classes of readers. This makes it a bit less clear than if it was only focusing on one or the other. After spending time working on this I need to let it sit and come back to read it fresh later to see if what I wrote is actually saying what I intended. If someone else would like to take a stab at it, that is always appreciated. (Obviously that has to be after, and if, my pending changes are approved.)