<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Mar 24, 2015 at 1:31 PM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span>On 03/24/2015 02:19 PM, Anne Gentle wrote:<br>
</span><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span>
<br>
<br>
On Mar 24, 2015, at 4:07 AM, Olga Gusarenko <<a href="mailto:ogusarenko@mirantis.com" target="_blank">ogusarenko@mirantis.com</a><br></span><span>
<mailto:<a href="mailto:ogusarenko@mirantis.com" target="_blank">ogusarenko@mirantis.<u></u>com</a>>> wrote:<br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Guys, I have problems with my patches that refer to playground admin<br>
user guide. There are probably issues with scopes.<br>
Here is the link to one of my commits:<br>
<a href="https://review.openstack.org/#/c/166786" target="_blank">https://review.openstack.org/#<u></u>/c/166786</a><br>
It could not pass the doc-public-checkbuild test (though the build was<br>
successful locally) until I marked the files with<br>
":scope:docs_for_admin" (and not "admin_only" as it is stated in the<br>
migration conventions).<br>
BUT now the files are not included to the guide built by Jenkins.<br>
<br>
What should I do in this case? What`s the plan for combining end-user<br>
and admin-user guides?<br>
</blockquote>
<br>
Andreas and I are working on a solution with this patch:<br>
<a href="https://review.openstack.org/#/c/166869/" target="_blank">https://review.openstack.org/#<u></u>/c/166869/</a><br>
<br>
More eyes would be great while we look for a solution.<br>
Thanks,<br>
Anne<br>
</span></blockquote>
<br>
I'm still struggling to get this working properly with all files, any help is welcome.<br>
<br>
But looking at User Guide and Admin Guide: Do we really need two guides that duplicate a lot? What about marking in the section title specific sections with "(Admin only)" instead and have one guide?</blockquote><div><br></div><div>I would love to hear from the User Guide specialty team as they work through the information architecture questions like this, would one guide be fine or even preferred? </div><div><br></div><div>We'll have to balance readability with maintainability, but I think the main idea is to move to "every page is page one" (topic authoring), so duplicating output pages isn't necessary because we don't need a "collection" in a guide in the topic-oriented world.</div><div><br></div><div>Still, I want to be sure we have similar features in re-use, and this was a good limited test of that. Glossary re-use is harder to solve so these lessons help us along the way!</div><div><br></div><div>Thank you for the help!</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span><font color="#888888"><br>
<br>
Andreas<br>
-- <br>
Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,<br>
Graham Norton, HRB 21284 (AG Nürnberg)<br>
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126</font></span><div><div><br>
<br>
<br>
______________________________<u></u>_________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.<u></u>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/<u></u>cgi-bin/mailman/listinfo/<u></u>openstack-docs</a><br>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</div></div>