docs: clear between current vs future plans
docs: clear between current vs future plans

Reorganized the developer docs so its clear between whats are future
plans and what things are documenting the current behavior.

Given a lot of the API docs are currently in flux, I have classed those
as future plans.

blueprint devref-refresh-liberty

Co-Authored-By: Michael Still <mikal@stillhq.com>

Change-Id: Ie79fcef909487ee1797274f0ca23854b2fb49d32

jianghuaw/nova,iuliat/nova,phenoxim/nova,jianghuaw/nova,devendermishrajio/nova_test_latest,Juniper/nova,MountainWei/nova,LoHChina/nova,yosshy/nova,barnsnake351/nova,TwinkleChawla/nova,ted-gould/nova,JioCloud/nova_test_latest,devendermishrajio/nova,vmturbo/nova,gooddata/openstack-nova,zzicewind/nova,fnordahl/nova,sebrandon1/nova,BeyondTheClouds/nova,zzicewind/nova,barnsnake351/nova,watonyweng/nova,noironetworks/nova,rajalokan/nova,CEG-FYP-OpenStack/scheduler,rajalokan/nova,gooddata/openstack-nova,jianghuaw/nova,bigswitch/nova,NeCTAR-RC/nova,noironetworks/nova,rahulunair/nova,scripnichenko/nova,rajalokan/nova,cyx1231st/nova,CCI-MOC/nova,watonyweng/nova,sebrandon1/nova,openstack/nova,hanlind/nova,hanlind/nova,devendermishrajio/nova_test_latest,vmturbo/nova,isyippee/nova,mmnelemane/nova,zhimin711/nova,rajalokan/nova,j-carpentier/nova,alaski/nova,apporc/nova,zhimin711/nova,vmturbo/nova,mikalstill/nova,j-carpentier/nova,CCI-MOC/nova,JianyuWang/nova,varunarya10/nova_test_latest,felixma/nova,vmturbo/nova,BeyondTheClouds/nova,apporc/nova,whitepages/nova,LoHChina/nova,hanlind/nova,gooddata/openstack-nova,rahulunair/nova,takeshineshiro/nova,dims/nova,MountainWei/nova,dims/nova,NeCTAR-RC/nova,Juniper/nova,cloudbase/nova,cloudbase/nova,cloudbase/nova,jianghuaw/nova,raildo/nova,JianyuWang/nova,CEG-FYP-OpenStack/scheduler,scripnichenko/nova,akash1808/nova_test_latest,nikesh-mahalka/nova,shail2810/nova,mmnelemane/nova,varunarya10/nova_test_latest,yosshy/nova,JioCloud/nova_test_latest,takeshineshiro/nova,openstack/nova,klmitch/nova,edulramirez/nova,whitepages/nova,felixma/nova,cernops/nova,klmitch/nova,phenoxim/nova,devendermishrajio/nova,BeyondTheClouds/nova,rahulunair/nova,ruslanloman/nova,klmitch/nova,nikesh-mahalka/nova,mikalstill/nova,edulramirez/nova,TwinkleChawla/nova,Francis-Liu/animated-broccoli,gooddata/openstack-nova,Juniper/nova,cernops/nova,mahak/nova,akash1808/nova_test_latest,cyx1231st/nova,klmitch/nova,openstack/nova,cernops/nova,bigswitch/nova,fnordahl/nova,iuliat/nova,ruslanloman/nova,alaski/nova,mahak/nova,Francis-Liu/animated-broccoli,Juniper/nova,mikalstill/nova,isyippee/nova,ted-gould/nova,sebrandon1/nova,raildo/nova,shail2810/nova,mahak/nova