Open Stack

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>:

> Sigh.
>
> [3] 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-
> authority/tree/README.rst#n97
> > 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 [1], 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 [2]
> > for this.
> >
> > Please also note that, per my comment at [3], 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.
> >
> > [1] https://developer.openstack.org/api-ref/shared-file-system/
> > [2] 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:
> unsubscribe
> >> 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
> > 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
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20170907/25c2c457/attachment.html>