<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Jul 19, 2013 at 3:50 PM, Lorin Hochstein <span dir="ltr"><<a href="mailto:lorin@nimbisservices.com" target="_blank">lorin@nimbisservices.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">My personal opinion is that it's OK to use them as long as you try to build the doc yourself to verify that nothing is broken. Reviewers should also verify that docs build until we get the proper gating in place.<span class="HOEnZb"><font color="#888888"><div>
<br></div></font></span></div></blockquote><div><br></div><div style>Yep, this. Thanks Lorin!</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">
<span class="HOEnZb"><font color="#888888"><div></div></font></span><div><span class="HOEnZb"><font color="#888888">Lorin </font></span><div><div class="h5"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Jul 19, 2013 at 4:39 PM, Nermina Miller <span dir="ltr"><<a href="mailto:nerminamiller@gmail.com" target="_blank">nerminamiller@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Thanks, Lorin! Is it better not to use the links until support is available? - n <div><div><span></span><br>
<br>On Friday, July 19, 2013, Lorin Hochstein wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr">Nermina:<div><br></div><div>It's not you, it's us. ;)</div><div><br></div><div>We currently do not have a gate check to verify links are valid. We're working on having the gate check do full doc builds so that that Gerrit won't allow people to commit changes that can break the docs.</div>
<div><br></div><div>I believe linkend is the correct way to do cross-referencing right now, and olink support is in the works for the future.</div><div><br></div><div>Take care,</div><div><br></div><div>Lorin</div></div>
<div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Jul 19, 2013 at 4:31 PM, Nermina Miller <span dir="ltr"><<a>nerminamiller@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Sorry to jump in on this discussion so late down the thread (on vacation with limited wifi) but I was the one who made the link in that particular commit. Should I continue I using links and, if so, what's the best way to do it without causing trouble? Thanks! - Nermina <div>
<div><span></span><br>
<br>On Friday, July 19, 2013, Lorin Hochstein wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><div class="gmail_quote">
On Thu, Jul 18, 2013 at 8:01 PM, David Cramer <span dir="ltr"><<a>david.cramer@rackspace.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div>On 07/18/2013 05:43 PM, Denis Bradford wrote:<br>
> While you're brainstorming, I'm curious why we don't use olinks, since<br>
> it's designed to handle cross-document references like this.<br>
<br>
</div>Funny you should mention that :-) It's next on my list and I've been<br>
trying to get to it all summer, but one thing or another keeps coming<br>
up. It's still a high priority for me though.<br>
<br>
As I understand it, olinks would not have changed anything in this case<br>
however. The document would have passed the gate job (which effectively<br>
would no longer check links at all), but still failed in the maven<br>
plugin since the target would be missing.<br>
<br>
What happened here is the system worked and prevented a mistake by<br>
alerting us to a real problem.<br>
<br></blockquote><div><br></div><div>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.</div>
<div><br></div><div>Lorin</div><div><br></div></div>-- <br><div dir="ltr">Lorin Hochstein<br><div>Lead Architect - Cloud Services</div><div>Nimbis Services, Inc.</div><div><a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a></div>
</div>
</div></div>
</blockquote>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div dir="ltr">Lorin Hochstein<br><div>Lead Architect - Cloud Services</div><div>Nimbis Services, Inc.</div><div><a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a></div>
</div>
</div>
</blockquote>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br><div dir="ltr">Lorin Hochstein<br><div>Lead Architect - Cloud Services</div><div>Nimbis Services, Inc.</div><div><a href="http://www.nimbisservices.com" target="_blank">www.nimbisservices.com</a></div>
</div>
</div></div></div></div></div>
<br>_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>