On 07/22/2017 11:44 PM, Kevin Benton wrote:
Could we just put a placeholder in those subprojects /admin directories that redirects to the networking guide?

You mean a single page that basically says :

All information is covered in the `Networking Guide <https://docs.openstack.org/neutron/latest/admin/networking-guide`_.

Yes, this could be done - do we really need this?

Akihiro, having an admin/ directory is not a must-have,

Andreas

On Sat, Jul 22, 2017 at 10:50 AM, Doug Hellmann <d...@doughellmann.com <mailto:d...@doughellmann.com>> wrote:

    Excerpts from Akihiro Motoki's message of 2017-07-23 02:13:40 +0900:
    > Hi,
    >
    > I have a question on admin/ document related to the networking guide
    > and would like to have advices from the documentation experts.
    >
    > It seems the check site by Doug expect all project have admin/ page.
    > In the case of neutron the situation is a bit special. We have the
    > networking guide as admin/ document
    > in the neutron repo and it covers not only neutron itself but also
    > neutron stadium projects.
    > It means the neutron stadium projects sometimes (often?) have no
    > admin/ directory in their own repos
    > in favor of adding contents to the networking guide in neutron.
    >
    > Should Individual neutron stadium projects have their own admin guide
    > in their repositories,
    > or is it better to keep the networking guide which covers all
    > networking stuff in a single guide?
    >
    > What is the suggested way on the networking guide as the document expert?

    If the admin guides for all of those repos are combined, then I can
    modify the burndown chart generator to not count those as needed. Let me
    know if that's the best approach.

    Doug

     >
     > Thanks,
     > Akihiro
     >
     > 2017-07-22 3:26 GMT+09:00 Doug Hellmann <d...@doughellmann.com
    <mailto:d...@doughellmann.com>>:
     > > We've made huge progress, and are launching the updated landing
     > > pages for docs.openstack.org <http://docs.openstack.org> as I
    write this. Thanks to all of the
     > > contributors who have stepped up to write nearly 1,000 patches to
     > > improve the health of our documentation!
     > >
     > > We still have around 70 URLs we expected to see after the migration
     > > was complete but that produce a 404. I know some of the patches to
     > > produce those pages are in progress, but please check the list at
     > > https://doughellmann.com/doc-migration/
    <https://doughellmann.com/doc-migration/> if your team is listed below
     > > to ensure that nothing has been missed.
     > >
     > >   cinder
     > >   cloudkitty
     > >   congress
     > >   designate
     > >   heat
     > >   ironic
     > >   karbor
     > >   keystone
     > >   magnum
     > >   manila
     > >   murano
     > >   neutron
     > >   nova
     > >   sahara
     > >   senlin
     > >   swift
     > >   tacker
     > >   telementry
     > >   tricircle
     > >   trove
     > >   vitrage
     > >   watcher
     > >   zaqar
     > >   zun
     > >
     > > Reply here or ping me in #openstack-docs if you have questions
    or need a
     > > hand.
     > >
     > > Doug
     > >
     > > _______________________________________________
     > > OpenStack-docs mailing list
     > > openstack-d...@lists.openstack.org
    <mailto:openstack-d...@lists.openstack.org>
     > >
    http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
    <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs>
     >

    __________________________________________________________________________
    OpenStack Development Mailing List (not for usage questions)
    Unsubscribe:
    openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
    <http://openstack-dev-requ...@lists.openstack.org?subject:unsubscribe>
    http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
    <http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev>




__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev



--
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,
       HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126


__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev

Reply via email to