clean up api_samples documentation
clean up api_samples documentation

the documentation for API samples was very misleading,
and hard to point people at what to do to add new samples.
Bring this more in line with reality.

Change-Id: I52da343d317cc77e5df30815f3f3721c2634585b

akash1808/nova,eonpatapon/nova,yrobla/nova,angdraug/nova,mandeepdhami/nova,mahak/nova,cernops/nova,cloudbase/nova-virtualbox,zhimin711/nova,adelina-t/nova,tangfeixiong/nova,badock/nova,blueboxgroup/nova,cloudbase/nova,vladikr/nova_drafts,tianweizhang/nova,alexandrucoman/vbox-nova-driver,OpenAcademy-OpenStack/nova-scheduler,fnordahl/nova,sridevikoushik31/openstack,BeyondTheClouds/nova,vmturbo/nova,maoy/zknova,silenceli/nova,Brocade-OpenSource/OpenStack-DNRM-Nova,zhimin711/nova,varunarya10/nova_test_latest,Yusuke1987/openstack_template,maheshp/novatest,ruslanloman/nova,hanlind/nova,TwinkleChawla/nova,hanlind/nova,bigswitch/nova,jianghuaw/nova,orbitfp7/nova,gspilio/nova,cloudbase/nova,tangfeixiong/nova,yatinkumbhare/openstack-nova,Triv90/Nova,mandeepdhami/nova,BeyondTheClouds/nova,tudorvio/nova,MountainWei/nova,Juniper/nova,JioCloud/nova,maheshp/novatest,tudorvio/nova,sridevikoushik31/nova,scripnichenko/nova,phenoxim/nova,dstroppa/openstack-smartos-nova-grizzly,TieWei/nova,imsplitbit/nova,iuliat/nova,luogangyi/bcec-nova,alvarolopez/nova,vmturbo/nova,yrobla/nova,zaina/nova,cloudbase/nova-virtualbox,silenceli/nova,phenoxim/nova,cloudbau/nova,SUSE-Cloud/nova,ntt-sic/nova,rrader/nova-docker-plugin,dawnpower/nova,isyippee/nova,shahar-stratoscale/nova,cernops/nova,maelnor/nova,zaina/nova,Stavitsky/nova,raildo/nova,maheshp/novatest,rahulunair/nova,Triv90/Nova,jianghuaw/nova,leilihh/nova,devendermishrajio/nova,whitepages/nova,alexandrucoman/vbox-nova-driver,Metaswitch/calico-nova,Tehsmash/nova,akash1808/nova,Juniper/nova,rrader/nova-docker-plugin,leilihh/novaha,ted-gould/nova,shootstar/novatest,dims/nova,gspilio/nova,akash1808/nova_test_latest,double12gzh/nova,mahak/nova,eayunstack/nova,mmnelemane/nova,rajalokan/nova,saleemjaveds/https-github.com-openstack-nova,jeffrey4l/nova,Yuriy-Leonov/nova,rickerc/nova_audit,varunarya10/nova_test_latest,petrutlucian94/nova,nikesh-mahalka/nova,NeCTAR-RC/nova,cloudbase/nova,apporc/nova,qwefi/nova,Brocade-OpenSource/OpenStack-DNRM-Nova,thomasem/nova,jianghuaw/nova,shail2810/nova,gooddata/openstack-nova,projectcalico/calico-nova,CEG-FYP-OpenStack/scheduler,gooddata/openstack-nova,rahulunair/nova,fnordahl/nova,saleemjaveds/https-github.com-openstack-nova,takeshineshiro/nova,plumgrid/plumgrid-nova,alaski/nova,bclau/nova,bclau/nova,Tehsmash/nova,Juniper/nova,Metaswitch/calico-nova,CCI-MOC/nova,JioCloud/nova_test_latest,Juniper/nova,dstroppa/openstack-smartos-nova-grizzly,berrange/nova,mgagne/nova,rajalokan/nova,felixma/nova,CCI-MOC/nova,vladikr/nova_drafts,dims/nova,BeyondTheClouds/nova,devoid/nova,felixma/nova,akash1808/nova_test_latest,tanglei528/nova,whitepages/nova,shahar-stratoscale/nova,gooddata/openstack-nova,bigswitch/nova,sebrandon1/nova,yosshy/nova,hanlind/nova,citrix-openstack-build/nova,CEG-FYP-OpenStack/scheduler,dawnpower/nova,badock/nova,shail2810/nova,rahulunair/nova,double12gzh/nova,eonpatapon/nova,openstack/nova,JioCloud/nova,alaski/nova,CiscoSystems/nova,watonyweng/nova,luogangyi/bcec-nova,petrutlucian94/nova_dev,CloudServer/nova,TieWei/nova,yrobla/nova,imsplitbit/nova,angdraug/nova,dstroppa/openstack-smartos-nova-grizzly,bgxavier/nova,affo/nova,petrutlucian94/nova,Yusuke1987/openstack_template,openstack/nova,petrutlucian94/nova_dev,kimjaejoong/nova,klmitch/nova,virtualopensystems/nova,klmitch/nova,watonyweng/nova,DirectXMan12/nova-hacking,nikesh-mahalka/nova,noironetworks/nova,ntt-sic/nova,tianweizhang/nova,isyippee/nova,ewindisch/nova,edulramirez/nova,jeffrey4l/nova,zzicewind/nova,ruslanloman/nova,eharney/nova,mikalstill/nova,mikalstill/nova,qwefi/nova,leilihh/novaha,maoy/zknova,redhat-openstack/nova,CiscoSystems/nova,cernops/nova,iuliat/nova,klmitch/nova,LoHChina/nova,sridevikoushik31/openstack,projectcalico/calico-nova,vmturbo/nova,belmiromoreira/nova,Francis-Liu/animated-broccoli,kimjaejoong/nova,mikalstill/nova,cyx1231st/nova,cyx1231st/nova,yatinkumbhare/openstack-nova,jianghuaw/nova,leilihh/nova,edulramirez/nova,ewindisch/nova,vmturbo/nova,devendermishrajio/nova_test_latest,rickerc/nova_audit,scripnichenko/nova,shootstar/novatest,sridevikoushik31/nova,affo/nova,maelnor/nova,noironetworks/nova,maoy/zknova,barnsnake351/nova,JioCloud/nova_test_latest,takeshineshiro/nova,yosshy/nova,devoid/nova,OpenAcademy-OpenStack/nova-scheduler,spring-week-topos/nova-week,sebrandon1/nova,tealover/nova,ted-gould/nova,eayunstack/nova,blueboxgroup/nova,raildo/nova,bgxavier/nova,gspilio/nova,thomasem/nova,mahak/nova,gooddata/openstack-nova,JianyuWang/nova,Triv90/Nova,belmiromoreira/nova,barnsnake351/nova,klmitch/nova,joker946/nova,DirectXMan12/nova-hacking,DirectXMan12/nova-hacking,apporc/nova,openstack/nova,cloudbau/nova,eharney/nova,Yuriy-Leonov/nova,NeCTAR-RC/nova,viggates/nova,sridevikoushik31/nova,spring-week-topos/nova-week,SUSE-Cloud/nova,TwinkleChawla/nova,plumgrid/plumgrid-nova,MountainWei/nova,j-carpentier/nova,joker946/nova,devendermishrajio/nova,LoHChina/nova,tealover/nova,rajalokan/nova,adelina-t/nova,sridevikoushik31/nova,tanglei528/nova,berrange/nova,devendermishrajio/nova_test_latest,CloudServer/nova,alvarolopez/nova,mgagne/nova,viggates/nova,sacharya/nova,sacharya/nova,rajalokan/nova,JianyuWang/nova,j-carpentier/nova,sebrandon1/nova,redhat-openstack/nova,citrix-openstack-build/nova,Stavitsky/nova,zzicewind/nova,mmnelemane/nova,virtualopensystems/nova,sridevikoushik31/openstack,orbitfp7/nova,Francis-Liu/animated-broccoli