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 <openst...@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-requ...@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-requ...@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-requ...@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-requ...@lists.openstack.org?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev