datacommonsorg / docsite

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

[v1-rest] Make a clearer note about returning the latest observation

beets opened this issue · comments

https://juliawu.github.io/datacommons-docsite/api/rest/v1/observations/point

The information is a little hidden that the latest observation is returned if a date isn't specified, especially since the main description says "Retrieve a specific observation at a set date from a variable for an entity." There should be a quick follow there that the latest is returned (otherwise you have to hunt for it in the query params). Users could be quickly scanning through APIs, and might miss this.

Should we also note here that this is from the preferred facet?