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

Akihiro Motoki amotoki at gmail.com
Sat Jul 22 17:13:40 UTC 2017


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?


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