<div dir="ltr">Thanks Jeremy Stanley, Anne Gentle and Eric Fried  for your perfect reply on this question. thanks </div><div class="gmail_extra"><br><div class="gmail_quote">2017-09-05 20:59 GMT+08:00 Eric Fried <span dir="ltr"><<a href="mailto:openstack@fried.cc" target="_blank">openstack@fried.cc</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Sigh.<br>
<br>
[3] <a href="https://review.openstack.org/#/c/495326/1/www/.htaccess@52" rel="noreferrer" target="_blank">https://review.openstack.org/#<wbr>/c/495326/1/www/.htaccess@52</a><br>
<div class="HOEnZb"><div class="h5"><br>
On 09/05/2017 07:30 AM, Eric Fried wrote:<br>
> Agree with everything fungi has said here.<br>
><br>
> Per<br>
> <a href="https://git.openstack.org/cgit/openstack/service-types-authority/tree/README.rst#n97" rel="noreferrer" target="_blank">https://git.openstack.org/<wbr>cgit/openstack/service-types-<wbr>authority/tree/README.rst#n97</a><br>
> we want the official service type to be singular rather than plural.<br>
><br>
> And per the doc migration movement, we want the API references to live<br>
> at standard URLs based on their official service type.<br>
><br>
> So the official API reference should indeed be at [1], which it seems to<br>
> be, as you pointed out.<br>
><br>
> However, I also agree with your point that there are obviously stale<br>
> links in the world pointing to the plural version, and adding a redirect<br>
> would be a good idea while those get cleaned up.  I have proposed [2]<br>
> for this.<br>
><br>
> Please also note that, per my comment at [3], I feel we should be moving<br>
> toward a place where sources linking to API references should be<br>
> gleaning the URLs dynamically from the service-types-authority rather<br>
> than hardcoding them.<br>
><br>
> [1] <a href="https://developer.openstack.org/api-ref/shared-file-system/" rel="noreferrer" target="_blank">https://developer.openstack.<wbr>org/api-ref/shared-file-<wbr>system/</a><br>
> [2] <a href="https://review.openstack.org/#/c/500792/" rel="noreferrer" target="_blank">https://review.openstack.org/#<wbr>/c/500792/</a><br>
><br>
> Thanks,<br>
> efried<br>
><br>
> On 09/04/2017 01:24 PM, Jeremy Stanley wrote:<br>
>> On 2017-09-04 12:45:59 -0500 (-0500), Anne Gentle wrote:<br>
>>> I want to say there are a couple of in-progress patches to clear<br>
>>> this up.<br>
>>><br>
>>> <a href="https://review.openstack.org/#/c/495326/" rel="noreferrer" target="_blank">https://review.openstack.org/#<wbr>/c/495326/</a><br>
>>> and<br>
>>> <a href="https://review.openstack.org/#/c/495887/" rel="noreferrer" target="_blank">https://review.openstack.org/#<wbr>/c/495887/</a><br>
>> [...]<br>
>><br>
>> Only insofar as the service-types-authority change is switching to<br>
>> match the URL where the document is now being published, but this<br>
>> doesn't actually address all the places where the old URL is still<br>
>> being used. At least that confirms for me that the new URL really is<br>
>> the one we want, so maybe the old "shared-file-systems" name should<br>
>> be added as an alias for the "shared-file-system" service (giving us<br>
>> a redirect as I understand it) and then cleanup of various uses for<br>
>> the old URL can happen at everyone's convenience?<br>
>><br>
>><br>
>><br>
>> ______________________________<wbr>______________________________<wbr>______________<br>
>> OpenStack Development Mailing List (not for usage questions)<br>
>> Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.<wbr>openstack.org?subject:<wbr>unsubscribe</a><br>
>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-dev</a><br>
>><br>
><br>
> ______________________________<wbr>______________________________<wbr>______________<br>
> OpenStack Development Mailing List (not for usage questions)<br>
> Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.<wbr>openstack.org?subject:<wbr>unsubscribe</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-dev</a><br>
><br>
<br>
______________________________<wbr>______________________________<wbr>______________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.<wbr>openstack.org?subject:<wbr>unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-dev</a><br>
</div></div></blockquote></div><br></div>