Update api doc with latest updates in api framework
Update api doc with latest updates in api framework

api.rst has many stale information now as we have done
many changes in api framework specially removal of
stevedore extensions loading and plain routing.

This commit modify this doc to reflect latest information
and remove v2 specific info which are no longer valid.

Note- in next part we will merge api_2.rst in this doc and
show 'adding api method' step by step.

Change-Id: I0628d8fa0b19c3fb09f1896402fc85dcae90916f

phenoxim/nova,klmitch/nova,jianghuaw/nova,mikalstill/nova,jianghuaw/nova,mahak/nova,openstack/nova,jianghuaw/nova,gooddata/openstack-nova,mikalstill/nova,openstack/nova,gooddata/openstack-nova,phenoxim/nova,mikalstill/nova,rahulunair/nova,mahak/nova,gooddata/openstack-nova,jianghuaw/nova,rahulunair/nova,klmitch/nova,klmitch/nova,gooddata/openstack-nova,rahulunair/nova,klmitch/nova,openstack/nova,mahak/nova