[#255] First part of API docs update for CKAN 2.0

The action API is now the default API.

Moved apiv3.rst -> api.rst.

Edited and rearranged apiv3.rst.

Removed the API quickstart tutorial as superfluous.

Removed the Tools for Accessing the API section as these tools
(particularly ckanclient) are out of date and unmaintained.

Moved what was in api.rst and api-v2.rst into legacy-api.rst.

Moved the Search API docs (which were mixed into apiv3.rst with the
Action API docs) into api-search.rst. The old version of the search API
is still documented in legacy-api.rst.
Merge branch 'master' of github.com:okfn/ckan into 255-update-api-docs
[#255] Move the Search API docs into Legacy API chapter

There was actuallt already a copy of the Search API docs in the
legacy-api.rst file, so just delete the api-search.rst file and remove
it from the index.
[#255] Move Util API docs into Legacy API chapter
[#255] Legacy API docs tweaks

Just tweak a couple of section headings and the introductory text
[#255] Rename API v3 -> Action API in docs

This is the correct name, because other named APIs (Datastore API, etc.)
may also have a v3, and the Action API may one day have a v4.
[#255] Tweak Action API docs intro

Mention RPC-style, and add lots of links to demo.ckan.org as examples.
[#255] Rename DataStore Data API -> DataStore API in docs
[#255] Edit FileStore API docs

Move the FileStore API docs into its own file (filestore-api.rst) same
as the Action API and DataStore API, and move it to the CKAN API section
in the table of contents.

Also renamed it Storage API -> FileStore API (since the feature is
called the FileStore), and added a link to the ckanclient code that
shows how to use it (since the documentation is hopeless).

On the FileStore page, where the FileStore API docs used to be put a
link to the new FileStore API page.

Edited the FileStore feature docs: rename Storage Web Interface ->
FileStore Web Interface (the feature seems to change names, from
FileStore to just Storage, half-way down the page).
[#255] Simplify API documentation table of contents

Only list the top-level sections, not subsesctions.
[#255] Break Action API reference into multiple pages
[#255] Autodoc API functions in source order

Put autodoc function listings in source order (was previously
alphabetical order) in docs.
[#255] Replace ckanclient Loading Data example

Replace the example of loading data using ckanclient in the docs with
one using the action api.

The rest of the Load Datasets page of the docs still looks pretty out of date.
[#255] Add an assert to an api example in the docs
[#255] Remove API Quickstart Tutorial file

It had already been removed from the table of contents
[#255] Edit DataStore API docs intro

Remove some unnecessary explanation, just refer to the Action API docs
instead.
[#255] Tweak some DataStore API example URLs

You don't actually have to put the version number in the URL, since it
defaults to 3 and 3 is the only possible version number.
[#255] Update an example API URL

Use action api not rest api
Merge branch 'master' of github.com:okfn/ckan into 255-update-api-docs
[#255] Fix a broken link in the API docs