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

Kevin Benton kevin at benton.pub
Sun Jul 23 08:31:25 UTC 2017


Yeah, I was just thinking it makes it more explicit that we haven't just
skipped doing an admin guide for a particular project.

On Sun, Jul 23, 2017 at 1:18 AM, Andreas Jaeger <aj at suse.com> wrote:

> 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`_
> <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 <doug at doughellmann.com
>> <mailto:doug at 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 <doug at doughellmann.com
>>     <mailto:doug at 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-docs at lists.openstack.org
>>     <mailto:OpenStack-docs at 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-request at lists.openstack.org?subject:unsubscribe
>>     <http://OpenStack-dev-request@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-request at lists.openstack.org?subject:unsubscrib
>> e
>> 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
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20170723/48e2251e/attachment.html>


More information about the OpenStack-dev mailing list