[openstack-dev] [infra][docs] Why Manila api-ref doc isn't published?
jun.zhongjun2 at gmail.com
Thu Sep 7 09:43:20 UTC 2017
Thanks Jeremy Stanley, Anne Gentle and Eric Fried for your perfect reply
on this question. thanks
2017-09-05 20:59 GMT+08:00 Eric Fried <openstack at fried.cc>:
>  https://review.openstack.org/#/c/495326/1/www/.htaccess@52
> On 09/05/2017 07:30 AM, Eric Fried wrote:
> > Agree with everything fungi has said here.
> > Per
> > https://git.openstack.org/cgit/openstack/service-types-
> > we want the official service type to be singular rather than plural.
> > And per the doc migration movement, we want the API references to live
> > at standard URLs based on their official service type.
> > So the official API reference should indeed be at , which it seems to
> > be, as you pointed out.
> > However, I also agree with your point that there are obviously stale
> > links in the world pointing to the plural version, and adding a redirect
> > would be a good idea while those get cleaned up. I have proposed 
> > for this.
> > Please also note that, per my comment at , I feel we should be moving
> > toward a place where sources linking to API references should be
> > gleaning the URLs dynamically from the service-types-authority rather
> > than hardcoding them.
> >  https://developer.openstack.org/api-ref/shared-file-system/
> >  https://review.openstack.org/#/c/500792/
> > Thanks,
> > efried
> > On 09/04/2017 01:24 PM, Jeremy Stanley wrote:
> >> On 2017-09-04 12:45:59 -0500 (-0500), Anne Gentle wrote:
> >>> I want to say there are a couple of in-progress patches to clear
> >>> this up.
> >>> https://review.openstack.org/#/c/495326/
> >>> and
> >>> https://review.openstack.org/#/c/495887/
> >> [...]
> >> Only insofar as the service-types-authority change is switching to
> >> match the URL where the document is now being published, but this
> >> doesn't actually address all the places where the old URL is still
> >> being used. At least that confirms for me that the new URL really is
> >> the one we want, so maybe the old "shared-file-systems" name should
> >> be added as an alias for the "shared-file-system" service (giving us
> >> a redirect as I understand it) and then cleanup of various uses for
> >> the old URL can happen at everyone's convenience?
> >> ____________________________________________________________
> >> OpenStack Development Mailing List (not for usage questions)
> >> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:
> >> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
> > ____________________________________________________________
> > OpenStack Development Mailing List (not for usage questions)
> > Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:
> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the OpenStack-dev