<div dir="ltr">Yeah, I was just thinking it makes it more explicit that we haven't just skipped doing an admin guide for a particular project.</div><div class="gmail_extra"><br><div class="gmail_quote">On Sun, Jul 23, 2017 at 1:18 AM, 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 class="">On 07/22/2017 11:44 PM, Kevin Benton wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Could we just put a placeholder in those subprojects /admin directories that redirects to the networking guide?<br>
</blockquote>
<br></span>
You mean a single page that basically says :<br>
<br>
All information is covered in the `Networking Guide <<a href="https://docs.openstack.org/neutron/latest/admin/networking-guide_" rel="noreferrer" target="_blank">https://docs.openstack.org/ne<wbr>utron/latest/admin/networking-<wbr>guide`_</a>.<br>
<br>
Yes, this could be done - do we really need this?<br>
<br>
Akihiro, having an admin/ directory is not a must-have,<br>
<br>
Andreas<br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div class="h5">
On Sat, Jul 22, 2017 at 10:50 AM, Doug Hellmann <<a href="mailto:doug@doughellmann.com" target="_blank">doug@doughellmann.com</a> <mailto:<a href="mailto:doug@doughellmann.com" target="_blank">doug@doughellmann.com</a>><wbr>> wrote:<br>
<br>
Excerpts from Akihiro Motoki's message of 2017-07-23 02:13:40 +0900:<br>
> Hi,<br>
><br>
> I have a question on admin/ document related to the networking guide<br>
> and would like to have advices from the documentation experts.<br>
><br>
> It seems the check site by Doug expect all project have admin/ page.<br>
> In the case of neutron the situation is a bit special. We have the<br>
> networking guide as admin/ document<br>
> in the neutron repo and it covers not only neutron itself but also<br>
> neutron stadium projects.<br>
> It means the neutron stadium projects sometimes (often?) have no<br>
> admin/ directory in their own repos<br>
> in favor of adding contents to the networking guide in neutron.<br>
><br>
> Should Individual neutron stadium projects have their own admin guide<br>
> in their repositories,<br>
> or is it better to keep the networking guide which covers all<br>
> networking stuff in a single guide?<br>
><br>
> What is the suggested way on the networking guide as the document expert?<br>
<br>
If the admin guides for all of those repos are combined, then I can<br>
modify the burndown chart generator to not count those as needed. Let me<br>
know if that's the best approach.<br>
<br>
Doug<br>
<br>
><br>
> Thanks,<br>
> Akihiro<br>
><br>
> 2017-07-22 3:26 GMT+09:00 Doug Hellmann <<a href="mailto:doug@doughellmann.com" target="_blank">doug@doughellmann.com</a><br></div></div>
<mailto:<a href="mailto:doug@doughellmann.com" target="_blank">doug@doughellmann.com</a>><wbr>>:<span class=""><br>
> > We've made huge progress, and are launching the updated landing<br></span>
> > pages for <a href="http://docs.openstack.org" rel="noreferrer" target="_blank">docs.openstack.org</a> <<a href="http://docs.openstack.org" rel="noreferrer" target="_blank">http://docs.openstack.org</a>> as I<div><div class="h5"><br>
write this. Thanks to all of the<br>
> > contributors who have stepped up to write nearly 1,000 patches to<br>
> > improve the health of our documentation!<br>
> ><br>
> > We still have around 70 URLs we expected to see after the migration<br>
> > was complete but that produce a 404. I know some of the patches to<br>
> > produce those pages are in progress, but please check the list at<br>
> > <a href="https://doughellmann.com/doc-migration/" rel="noreferrer" target="_blank">https://doughellmann.com/doc-m<wbr>igration/</a><br>
<<a href="https://doughellmann.com/doc-migration/" rel="noreferrer" target="_blank">https://doughellmann.com/doc-<wbr>migration/</a>> if your team is listed below<br>
> > to ensure that nothing has been missed.<br>
> ><br>
> > cinder<br>
> > cloudkitty<br>
> > congress<br>
> > designate<br>
> > heat<br>
> > ironic<br>
> > karbor<br>
> > keystone<br>
> > magnum<br>
> > manila<br>
> > murano<br>
> > neutron<br>
> > nova<br>
> > sahara<br>
> > senlin<br>
> > swift<br>
> > tacker<br>
> > telementry<br>
> > tricircle<br>
> > trove<br>
> > vitrage<br>
> > watcher<br>
> > zaqar<br>
> > zun<br>
> ><br>
> > Reply here or ping me in #openstack-docs if you have questions<br>
or need a<br>
> > hand.<br>
> ><br>
> > Doug<br>
> ><br>
> > ______________________________<wbr>_________________<br>
> > OpenStack-docs mailing list<br>
> > <a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.openstack<wbr>.org</a><br></div></div>
<mailto:<a href="mailto:OpenStack-docs@lists.openstack.org" target="_blank">OpenStack-docs@lists.o<wbr>penstack.org</a>><br>
> ><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi<wbr>-bin/mailman/listinfo/openstac<wbr>k-docs</a><span class=""><br>
<<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/cg<wbr>i-bin/mailman/listinfo/opensta<wbr>ck-docs</a>><br>
><br>
<br>
______________________________<wbr>______________________________<wbr>______________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe:<br>
<a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.op<wbr>enstack.org?subject:unsubscrib<wbr>e</a><br></span>
<<a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">http://OpenStack-dev-request@<wbr>lists.openstack.org?subject:un<wbr>subscribe</a>><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi<wbr>-bin/mailman/listinfo/openstac<wbr>k-dev</a><br>
<<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cg<wbr>i-bin/mailman/listinfo/opensta<wbr>ck-dev</a>><span class=""><br>
<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.op<wbr>enstack.org?subject:unsubscrib<wbr>e</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi<wbr>-bin/mailman/listinfo/openstac<wbr>k-dev</a><br>
<br>
</span></blockquote><span class="HOEnZb"><font color="#888888">
<br>
<br>
-- <br>
Andreas Jaeger aj@{<a href="http://suse.com" rel="noreferrer" target="_blank">suse.com</a>,<a href="http://opensuse.org" rel="noreferrer" target="_blank">opensuse.org</a>} Twitter: jaegerandi<br>
SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
GF: Felix Imendörffer, Jane Smithard, Graham Norton,<br>
HRB 21284 (AG Nürnberg)<br>
GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br>
<br>
</font></span></blockquote></div><br></div>