seperated the registry and index API's into their own docs

seperated the registry and index API's into their own docs and merged
in the index search api into the index api. Also renamed the original
registry api to registry_index_spec.

replacement for #805 same content just rebased on a new branch to fix the merging/rebasing issues.