add some more docs and make it more obvious which parts are examples
add some more docs and make it more obvious which parts are examples

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