[openstack-dev] [docs][neutron] doc-migration status

Doug Hellmann doug at doughellmann.com
Sat Jul 22 17:50:15 UTC 2017


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 <doug at doughellmann.com>:
> > We've made huge progress, and are launching the updated landing
> > pages for 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/ 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-docs at lists.openstack.org
> > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
> 



More information about the OpenStack-dev mailing list