Re: [openstack-dev] [Cinder][Nova][Keystone][docs] Version responses links

2014-04-29 Thread Diane Fleming
I would prefer to link to docs.openstack.org or the API reference pages with specific links like this: http://api.openstack.org/api-ref-blockstorage-v2.html, http://api.openstack.org/api-ref-compute-v2.html, and so on. The issue I have with linking to the "specs" is that they are likely going to m

Re: [openstack-dev] [Cinder][Nova][Keystone][docs] Version responses links

2014-04-27 Thread Mike Perez
On 19:19 Sun 27 Apr , Andreas Jaeger wrote: > So, my proposal would be: > * Remove WADL links > * Have PDF links to go http://docs.openstack.org > * For those current links to the site http://docs.openstack.org: Take > care that they point either to a current file or get redirected to > htt

Re: [openstack-dev] [Cinder][Nova][Keystone][docs] Version responses links

2014-04-27 Thread Dolph Mathews
On Sun, Apr 27, 2014 at 12:19 PM, Andreas Jaeger wrote: > The documentation team noticed that we have links in the version > responses of several APIs that contain URLs that do not exist at all. > > For example, cinder includes a link to > " > http://jorgew.github.com/block-storage-api/content/os

[openstack-dev] [Cinder][Nova][Keystone][docs] Version responses links

2014-04-27 Thread Andreas Jaeger
The documentation team noticed that we have links in the version responses of several APIs that contain URLs that do not exist at all. For example, cinder includes a link to "http://jorgew.github.com/block-storage-api/content/os-block-storage-1.0.pdf"; - and jorgew.github.com does not exist as hos