[Openstack-docs] Links to another manual

Lorin Hochstein lorin at nimbisservices.com
Fri Jul 19 17:35:50 UTC 2013


On Thu, Jul 18, 2013 at 8:01 PM, David Cramer <david.cramer at rackspace.com>wrote:

> On 07/18/2013 05:43 PM, Denis Bradford wrote:
> > While you're brainstorming, I'm curious why we don't use olinks, since
> > it's designed to handle cross-document references like this.
>
> Funny you should mention that :-) It's next on my list and I've been
> trying to get to it all summer, but one thing or another keeps coming
> up. It's still a high priority for me though.
>
> As I understand it, olinks would not have changed anything in this case
> however. The document would have passed the gate job (which effectively
> would no longer check links at all), but still failed in the maven
> plugin since the target would be missing.
>
> What happened here is the system worked and prevented a mistake by
> alerting us to a real problem.
>
>
Just to be clear... the system *didn't* work here: docs were committed to
master that broke the build, and that should never happen. We really need a
maven job that gate on master to prevent this in the future.

Lorin

-- 
Lorin Hochstein
Lead Architect - Cloud Services
Nimbis Services, Inc.
www.nimbisservices.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130719/610a346a/attachment.html>


More information about the Openstack-docs mailing list