sample-data/data.yaml should have API examples

[ultrasaurus]

it's supported by the app, but I never added it to sample data

examples:
- name: Chicago
  description: all of the data for a city by a specific name
  params: name=Chicago
- name: Multiple Values
  description: all of the cities in New York and Massachusetts
  params: state=NY,MA
- name: Partial Data
  description: all of the cities in California, but only return name and size
  params: state=CA&fields=name,size

[ultrasaurus]

would be good to add dot notation with the new sample data that @slhaines is working on, something like...
fields=capital.name,capital.population if we want to get only part of the data about all of the cities or for cities with more than 500,000 people, it would be something like this: capital.population__range=500000...fields=capital.name,capital.population