<div dir="ltr">As long as these cross-refs do not influence the search optimization, I would not touch these for now. Or do they?<div><br></div><div>Anyways, I didn't change these in my patch [1] either.<div><br></div><div> [1] <a href="https://review.openstack.org/#/c/353043">https://review.openstack.org/#/c/353043</a></div></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Aug 4, 2016 at 9:51 PM, Akihiro Motoki <span dir="ltr"><<a href="mailto:amotoki@gmail.com" target="_blank">amotoki@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">2016-08-04 11:35 GMT+09:00 Anne Gentle <<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><wbr>>:<br>
> Thanks for this! I'm updating it as I test with the admin-guide. Yep, you<br>
> need to be in the /source/ directory for non-common files as that's where<br>
> the RST files are.<br>
><br>
> One new question I have. Should I not update the inserted cross reference<br>
> markers at the tops of sections, such as ..<br>
> _shared_file_systems_share_<wbr>types: even though the file name is now<br>
> shared-file-systems-share-<wbr>types?<br>
<br>
</span>This is a gray zone. When I worked on 'common' document, I did not<br>
touch cross references, but I am okay with either decision.<br>
<br>
BTW, manila-related documents in the admin guide have cross references<br>
like ".. _shared_file_systems_share_<wbr>types:" but it seems they are not<br>
used anywhere. Looks unnecessary.<br>
<span class="HOEnZb"><font color="#888888"><br>
Akihiro<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
><br>
> Thanks,<br>
> Anne<br>
><br>
> On Tue, Aug 2, 2016 at 11:06 PM, Akihiro Motoki <<a href="mailto:amotoki@gmail.com">amotoki@gmail.com</a>> wrote:<br>
>><br>
>> I shared my log to a etherpad page when I worked on 'common' file<br>
>> renaming.<br>
>> It may help you work on other guides.<br>
>><br>
>> <a href="https://etherpad.openstack.org/p/docs-file-renaming" rel="noreferrer" target="_blank">https://etherpad.openstack.<wbr>org/p/docs-file-renaming</a><br>
>><br>
>> 2016-08-02 22:11 GMT+09:00 Anne Gentle <<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><wbr>>:<br>
>> > No problem.<br>
>> ><br>
>> ><br>
>> > <a href="https://blueprints.launchpad.net/openstack-manuals/+spec/consistency-file-rename" rel="noreferrer" target="_blank">https://blueprints.launchpad.<wbr>net/openstack-manuals/+spec/<wbr>consistency-file-rename</a><br>
>> ><br>
>> > On Mon, Aug 1, 2016 at 6:26 PM, Lana Brindley<br>
>> > <<a href="mailto:openstack@lanabrindley.com">openstack@lanabrindley.com</a>><br>
>> > wrote:<br>
>> >><br>
>> >> Hi Anne,<br>
>> >><br>
>> >> Sorry to be a pain, but can I please get a blueprint off you too? It'll<br>
>> >> make it easier to track relevant reviews, I think.<br>
>> >><br>
>> >> L<br>
>> >><br>
>> >> On 30/07/16 13:53, Anne Gentle wrote:<br>
>> >> > Thanks all!<br>
>> >> ><br>
>> >> > Spec is now updated with further clarity on tasks and assignees.<br>
>> >> ><br>
>> >> > Anne<br>
>> >> ><br>
>> >> > On Fri, Jul 29, 2016 at 5:43 PM, Mariia Zlatkova<br>
>> >> > <<a href="mailto:mzlatkova@mirantis.com">mzlatkova@mirantis.com</a>> wrote:<br>
>> >> >> Hi all,<br>
>> >> >><br>
>> >> >> I can pick up the user guide.<br>
>> >> >><br>
>> >> >> Thanks,<br>
>> >> >> Maria<br>
>> >> >><br>
>> >> >> Hi again all,<br>
>> >> >><br>
>> >> >> Thanks so much for your responses and willingness to help.<br>
>> >> >><br>
>> >> >> Based on the spec review, we do think this work is possible in the<br>
>> >> >> Newton release, and I'd like to find assignees for each "directory"<br>
>> >> >> and add those to the spec at<br>
>> >> >> <a href="https://review.openstack.org/#/c/345639/" rel="noreferrer" target="_blank">https://review.openstack.org/#<wbr>/c/345639/</a><br>
>> >> >> before we merge the spec.<br>
>> >> >><br>
>> >> >> I think I see it as:<br>
>> >> >><br>
>> >> >> admin-guide: Anne Gentle<br>
>> >> >> cli-reference: Kato Tomoyuki<br>
>> >> >> config-reference: Kato Tomoyuki<br>
>> >> >> common: needs an owner, Oleana are you interested and available?<br>
>> >> >> ops-guide: needs an owner<br>
>> >> >> user-guide: needs an owner<br>
>> >> >><br>
>> >> >> Edgar, the networking guide didn't have any underscores except for<br>
>> >> >> common files, so you could pick up the common files if you want!<br>
>> >> >><br>
>> >> >> Please write back here and/or review the spec.<br>
>> >> >> Thanks!<br>
>> >> >> Anne<br>
>> >> >><br>
>> >> >> On Thu, Jul 21, 2016 at 8:09 PM, Kato, Tomoyuki<br>
>> >> >> <<a href="mailto:kato.tomoyuki@jp.fujitsu.com">kato.tomoyuki@jp.fujitsu.com</a>> wrote:<br>
>> >> >>>> Hi all,<br>
>> >> >>>><br>
>> >> >>>> I'll say it's not as bad as I originally thought. I wrote up the<br>
>> >> >>>> spec<br>
>> >> >>>> here:<br>
>> >> >>>><br>
>> >> >>>> <a href="https://review.openstack.org/345639" rel="noreferrer" target="_blank">https://review.openstack.org/<wbr>345639</a><br>
>> >> >>>><br>
>> >> >>>> These guides are affected:<br>
>> >> >>>> admin-guide<br>
>> >> >>>> cli-reference (glance_property_keys.rst is the only file)<br>
>> >> >>>> ops-guide<br>
>> >> >>>> user-guide<br>
>> >> >>>><br>
>> >> >>>> source/common/<br>
>> >> >>>><br>
>> >> >>>> I have a couple of questions on the review:<br>
>> >> >>>><br>
>> >> >>>> Do we want this set of changes for newton? Only the cli-reference<br>
>> >> >>>> is<br>
>> >> >>>> "versioned" currently.<br>
>> >> >>>> How are the <guide-name>/source/common/ files sourced? (Hoping<br>
>> >> >>>> those<br>
>> >> >>>> are a change once get many proposition.)<br>
>> >> >>>><br>
>> >> >>>> Thanks,<br>
>> >> >>>> Anne<br>
>> >> >>><br>
>> >> >>> CLI Reference is not versioned.<br>
>> >> >>> Since glance_property_keys.rst is a included file at now,<br>
>> >> >>> however, I'd like to change it for Newton.<br>
>> >> >>><br>
>> >> >>> Also, my +1 to change all guides for consistency.<br>
>> >> >>><br>
>> >> >>> Thanks,<br>
>> >> >>> KATO Tomoyuki<br>
>> >> >>> ______________________________<wbr>_________________<br>
>> >> >>> OpenStack-docs mailing list<br>
>> >> >>> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.<wbr>openstack.org</a><br>
>> >> >>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
>> >> >><br>
>> >> >><br>
>> >> >><br>
>> >> >> --<br>
>> >> >> Anne Gentle<br>
>> >> >> <a href="http://www.justwriteclick.com" rel="noreferrer" target="_blank">www.justwriteclick.com</a><br>
>> >> >><br>
>> >> >> ______________________________<wbr>_________________<br>
>> >> >> OpenStack-docs mailing list<br>
>> >> >> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.<wbr>openstack.org</a><br>
>> >> >> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
>> >> ><br>
>> >> ><br>
>> >> ><br>
>> >><br>
>> >> --<br>
>> >> Lana Brindley<br>
>> >> Technical Writer<br>
>> >> Rackspace Cloud Builders Australia<br>
>> >> <a href="http://lanabrindley.com" rel="noreferrer" target="_blank">http://lanabrindley.com</a><br>
>> >><br>
>> >><br>
>> >> ______________________________<wbr>_________________<br>
>> >> OpenStack-docs mailing list<br>
>> >> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.<wbr>openstack.org</a><br>
>> >> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
>> >><br>
>> ><br>
>> ><br>
>> ><br>
>> > --<br>
>> > Anne Gentle<br>
>> > <a href="http://www.justwriteclick.com" rel="noreferrer" target="_blank">www.justwriteclick.com</a><br>
>> ><br>
>> > ______________________________<wbr>_________________<br>
>> > OpenStack-docs mailing list<br>
>> > <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.<wbr>openstack.org</a><br>
>> > <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
>> ><br>
>><br>
>> ______________________________<wbr>_________________<br>
>> OpenStack-docs mailing list<br>
>> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.<wbr>openstack.org</a><br>
>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
><br>
><br>
><br>
><br>
> --<br>
> Anne Gentle<br>
> <a href="http://www.justwriteclick.com" rel="noreferrer" target="_blank">www.justwriteclick.com</a><br>
<br>
______________________________<wbr>_________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.<wbr>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div>Best regards,</div>Olena Logvinova,<div>Technical Writer | Mirantis, Kharkiv | 38, Nauki av., Kharkiv</div><div><a href="mailto:ologvinova@mirantis.com" style="color:rgb(17,85,204)" target="_blank">ologvinova@mirantis.com</a> | <a href="tel:%2B380950903196" value="+380669377102" style="color:rgb(17,85,204)" target="_blank">+380950903196</a></div></div></div></div></div>
</div>