<div dir="ltr">Thanks for this! I'm updating it as I test with the admin-guide. Yep, you need to be in the /source/ directory for non-common files as that's where the RST files are.<div><br></div><div>One new question I have. Should I not update the inserted cross reference markers at the tops of sections, such as .. _shared_file_systems_share_types: even though the file name is now shared-file-systems-share-types?</div><div><br></div><div>Thanks,</div><div>Anne</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Aug 2, 2016 at 11:06 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">I shared my log to a etherpad page when I worked on 'common' file 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.org/p/docs-file-renaming</a><br>
<div class="HOEnZb"><div class="h5"><br>
2016-08-02 22:11 GMT+09:00 Anne Gentle <<a href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>>:<br>
> No problem.<br>
><br>
> <a href="https://blueprints.launchpad.net/openstack-manuals/+spec/consistency-file-rename" rel="noreferrer" target="_blank">https://blueprints.launchpad.net/openstack-manuals/+spec/consistency-file-rename</a><br>
><br>
> On Mon, Aug 1, 2016 at 6:26 PM, Lana Brindley <<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 <a href="https://review.openstack.org/#/c/345639/" rel="noreferrer" target="_blank">https://review.openstack.org/#/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 spec<br>
>> >>>> here:<br>
>> >>>><br>
>> >>>> <a href="https://review.openstack.org/345639" rel="noreferrer" target="_blank">https://review.openstack.org/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 is<br>
>> >>>> "versioned" currently.<br>
>> >>>> How are the <guide-name>/source/common/ files sourced? (Hoping 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>
>> >>> _______________________________________________<br>
>> >>> OpenStack-docs mailing list<br>
>> >>> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
>> >>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/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>
>> >> _______________________________________________<br>
>> >> OpenStack-docs mailing list<br>
>> >> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
>> >> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/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>
>> _______________________________________________<br>
>> OpenStack-docs mailing list<br>
>> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/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>
> _______________________________________________<br>
> OpenStack-docs mailing list<br>
> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
><br>
<br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/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>Anne Gentle</div><div><a href="http://www.justwriteclick.com" style="font-size:12.8px" target="_blank">www.justwriteclick.com</a><br></div></div></div></div></div>
</div>