Re: [openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-07 Thread Andreas Jaeger
An easy way to check for broken links: http://codesearch.openstack.org/?q=docs.openstack.org%2Fdeveloper=nope== We moved everything out from docs.openstack.org/developer, any such link in your code is outdated and needs updating, Andreas -- Andreas Jaeger aj@{suse.com,opensuse.org} Twitter:

Re: [openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-06 Thread Doug Hellmann
Excerpts from Jeremy Stanley's message of 2017-09-06 19:00:05 +: > On 2017-09-06 14:46:54 -0400 (-0400), Doug Hellmann wrote: > [...] > > To be clear, if you can get Sphinx's linkchecker builder to work, > > that's a great option for this. I just don't think you really want > > to run it for

Re: [openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-06 Thread Jeremy Stanley
On 2017-09-06 14:46:54 -0400 (-0400), Doug Hellmann wrote: [...] > To be clear, if you can get Sphinx's linkchecker builder to work, > that's a great option for this. I just don't think you really want > to run it for every check or gate job that builds the docs. Running a periodic pipeline job

Re: [openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-06 Thread Doug Hellmann
Excerpts from Alexandra Settle's message of 2017-09-06 17:47:44 +: > > > On 9/6/17, 12:10 PM, "Doug Hellmann" wrote: > > Excerpts from Doug Hellmann's message of 2017-09-05 13:53:40 -0400: > > Excerpts from Boden Russell's message of 2017-09-05 11:25:34

Re: [openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-06 Thread Alexandra Settle
On 9/6/17, 12:10 PM, "Doug Hellmann" wrote: Excerpts from Doug Hellmann's message of 2017-09-05 13:53:40 -0400: > Excerpts from Boden Russell's message of 2017-09-05 11:25:34 -0600: > > > > On 9/5/17 11:03 AM, Doug Hellmann wrote: > > > Is eventlet

Re: [openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-06 Thread Doug Hellmann
Excerpts from Doug Hellmann's message of 2017-09-05 13:53:40 -0400: > Excerpts from Boden Russell's message of 2017-09-05 11:25:34 -0600: > > > > On 9/5/17 11:03 AM, Doug Hellmann wrote: > > > Is eventlet being initialized (or partially initialized) when a module > > > from the application is

Re: [openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-05 Thread Tim Burke
On Sep 5, 2017, at 10:53 AM, Doug Hellmann wrote: > > Excerpts from Boden Russell's message of 2017-09-05 11:25:34 -0600: >> >> On 9/5/17 11:03 AM, Doug Hellmann wrote: >>> Is eventlet being initialized (or partially initialized) when a module >>> from the application is

Re: [openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-05 Thread Doug Hellmann
Excerpts from Boden Russell's message of 2017-09-05 11:25:34 -0600: > > On 9/5/17 11:03 AM, Doug Hellmann wrote: > > Is eventlet being initialized (or partially initialized) when a module > > from the application is imported for the auto-generated API > > documentation? > More than likely :) >

Re: [openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-05 Thread Boden Russell
On 9/5/17 11:03 AM, Doug Hellmann wrote: > Is eventlet being initialized (or partially initialized) when a module > from the application is imported for the auto-generated API > documentation? More than likely :) But even if they are, what's the fix/workaround?

Re: [openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-05 Thread Doug Hellmann
Excerpts from Boden Russell's message of 2017-09-05 10:51:09 -0600: > We've (neutron) run into a few cases where our doc links become > outdated/invalid and are dead. These dead links are not detected in the > doc build today, but is something we might be interested in enabling. > > I'm no sphinx

[openstack-dev] [docs][neutron] checking link integrity in the gate

2017-09-05 Thread Boden Russell
We've (neutron) run into a few cases where our doc links become outdated/invalid and are dead. These dead links are not detected in the doc build today, but is something we might be interested in enabling. I'm no sphinx expert, but best I can tell that's done with the "linkcheck" builder [1].