[ckan-discuss] Update Data API tutorial

[Rufus Pollock]

On 25 April 2012 11:31, Sean Hammond <sean.hammond at okfn.org> wrote:
>> Hi All,
[...]

>> This tutorial complements general info on the DataStore here:
>>
>> <http://docs.ckan.org/en/latest/datastore.html>
>
> If I just arrive directly at the 'Using the Data API' page (rather than
> clicking through to it from the earlier 'DataStore and the Data API'
> page) then it's a little confusing. I think the intro on the 'Using the
> Data API' page could do with a couple more sentences:

Hmm. I don't wnat to duplicate too much from the other page. I've now
added a link back to the DataStore page.

> 1. What is the data API and what can you do with it? All I know is it's
> an API that builds on ElasticSearch, so I was surprised when I saw
> examples of adding data etc. (not just searching). 'DataStore' isn't

Had you read the DataStore page before :-)

> mentioned. Maybe cross-ref the earlier chapter about the DataStore.

Done.

> 2. What is ElasticSearch (and link to ElasticSearch)

Done.

> I didn't know what {{endpoint}} should be until I looked back at the
> slideshow on the 'DataStore and the Data API' page. Maybe add a concrete
> example?

Done.

Thanks for the useful feedback :-)

Rufus