Queries for each insight pane (Top Stories, Top Entities, etc) are all the same, but the responses are different.
It is difficult to understand how to construct an API request from the queries.
Query should be called "Request", because in the Query pane there is a field called "query"
Right now:
Demo makes a single API call and uses sections of the response for different insights
"View Query" Query tab is identical for each pane
Response tab is different for each pane
What should happen:
Separate requests for each pane to facilitate easy understanding. When someone views the request for the Top Entities pane, they should learn how to get Top Entities alone, not Top Entities, Concepts, Sentiment, etc.
Or the app should more clearly explain that the response in each section is a subset of the single large response
"View Query" button and "Query" tab should be called "View Request" / "Request", because Discovery has a specific parameter called "query" that is shown in the "Query" tab
Right now:
What should happen: