<html><head><meta http-equiv="Content-Type" content="text/html charset=iso-8859-1"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div style="margin: 0px; font-size: 12px; ">Dear Tim,</div><div style="margin: 0px; font-size: 12px; min-height: 14px; "><br></div><div style="margin: 0px; font-size: 12px; ">Instead of quickly fixing this issue and creating a new release today we've decided to halt the deployment of any new release for now. </div><div style="margin: 0px; font-size: 12px; min-height: 14px; "><br></div><div style="margin: 0px; font-size: 12px; ">This is very embarrassing and we're very sorry for this. We obviously put too much trust in the framework that generates the documentation and we don't have the proper mechanisms in place to validate the correctness of the documentation generated. We will give this our fullest attention the coming days and expect to have a working solution sometime next week.</div><div style="margin: 0px; font-size: 12px; min-height: 14px; "><br></div><div style="margin: 0px; font-size: 12px; ">In the meantime I hope the existing documentation in TEST Database contains the information you need to proceed with your project. If you have any questions about how the API works then please contact us directly and we'll gladly help you out.</div><div style="margin: 0px; font-size: 12px; min-height: 14px; "><br></div><div style="margin: 0px; font-size: 12px; ">Kind regards,</div><div style="margin: 0px; font-size: 12px; min-height: 14px; "><br></div><div style="margin: 0px; font-size: 12px; ">Johan Åhlén</div><div style="margin: 0px; font-size: 12px; ">Assistant Manager Database</div><div style="margin: 0px; font-size: 12px; ">RIPE NCC</div><div style="margin: 0px; font-size: 12px; "><br></div><div><div>On 15 Aug 2013, at 17:20, Tim Garrison <<a href="mailto:tgarrison@softlayer.com">tgarrison@softlayer.com</a>> wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite">
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
<div text="#000000" bgcolor="#FFFFFF">
<div class="moz-cite-prefix">I would like to report that there
appear to be some broken links in the documentation still. For
example, on
<meta http-equiv="content-type" content="text/html;
charset=ISO-8859-1">
<a href="https://rest-test.db.ripe.net/api-doc/path__create.html">https://rest-test.db.ripe.net/api-doc/path__create.html</a>
there is a link to the "whois-resources" element, which points to
<meta http-equiv="content-type" content="text/html;
charset=ISO-8859-1">
<a href="https://rest-test.db.ripe.net/api-doc/el_ns0_whois-resources.html">https://rest-test.db.ripe.net/api-doc/el_ns0_whois-resources.html</a>
. This link produces a 404.<br>
<br>
<div class="moz-signature"><span style="font-family: Arial;">Tim
Garrison<br>
Software Engineer III<br>
<br>
<b>SoftLayer, an IBM Company</b><br>
315 Capitol Street Suite 205, Houston, TX 77002<br>
281.714.4213 direct | 713.540.4325 mobile | 281.714.4657 fax |
<a class="moz-txt-link-abbreviated" href="mailto:tgarrison@softlayer.com">tgarrison@softlayer.com</a>
</span><br>
<br>
</div>
On 08/15/2013 09:10 AM, Johan Åhlén wrote:<br>
</div>
<blockquote cite="mid:DE4CCCC5-984C-4B28-987D-B9560F866226@ripe.net" type="cite">
<meta http-equiv="Content-Type" content="text/html;
charset=ISO-8859-1">
<div>Dear all,</div>
<div><br>
</div>
<div>The release containing the fix is now available in the TEST
Database and there's a service announcement on the web page.</div>
<div><br>
</div>
<div>If there are no objections to this we will proceed with 24h
in the TEST Database and put this release in production on the
RIPE Database tomorrow at 16:00. Please go ahead and test your
applications against the version in the TEST Database.</div>
<div><br>
</div>
<div>The URL for the REST API in TEST is:</div>
<div><br>
</div>
<div> http(s)://<a moz-do-not-send="true" href="http://rest-test.db.ripe.net/">rest-test.db.ripe.net</a></div>
<div><br>
</div>
<div>Kind regards,</div>
<div><br>
</div>
<div>Johan Åhlén</div>
<div>Assistant Manager Database</div>
<div>RIPE NCC</div>
<br>
<div>
<div>On 15 Aug 2013, at 15:37, Tim Garrison <<a moz-do-not-send="true" href="mailto:tgarrison@softlayer.com">tgarrison@softlayer.com</a>>
wrote:</div>
<br class="Apple-interchange-newline">
<blockquote type="cite">
<div text="#000000" bgcolor="#FFFFFF">
<div class="moz-cite-prefix">That seems like a reasonable
approach to me.<br>
<div class="moz-signature"><br>
<span style="font-family: Arial;"> Tim Garrison<br>
Software Engineer III<br>
<br>
<b>SoftLayer, an IBM Company</b><br>
315 Capitol Street Suite 205, Houston, TX 77002<br>
281.714.4213 direct | 713.540.4325 mobile |
281.714.4657 fax | <a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:tgarrison@softlayer.com">tgarrison@softlayer.com</a>
</span><br>
<br>
</div>
On 08/15/2013 08:32 AM, Job Snijders wrote:<br>
</div>
<blockquote cite="mid:D7DDBFC2-F27E-4BD3-9755-D636033C7483@atrato.com" type="cite">
<pre wrap="">Hi,
Any reason not to deploy on test environmen, wait 24 hours, proceed to roll out on production environment?
Kind regards,
Job
On Aug 15, 2013, at 3:27 PM, Johan Åhlén <a moz-do-not-send="true" class="moz-txt-link-rfc2396E" href="mailto:jahlen@ripe.net"><jahlen@ripe.net></a> wrote:
</pre>
<blockquote type="cite">
<pre wrap="">Dear Ruediger,
Thank you for the input. As you are all aware the release procedure is new and does require some tuning, so in that aspect any suggestions on how we can improve this are welcome.
In this particular situation our assessment is that the broken links in the documentation indeed has a service impact. For some users this could be critical as they may not be able to use the REST API service. At least one case was reported to us where the development towards the API has come to a halt because of this.
Perhaps in this case we can hold the deployment of the fix until the working group advices us on how to proceed.
Kind regards,
Johan Åhlén
Assistant Database Manager
RIPE NCC
On 15 Aug 2013, at 14:52, "Ruediger Volk, Deutsche Telekom Technik - FMED-41.." <a moz-do-not-send="true" class="moz-txt-link-rfc2396E" href="mailto:rv@NIC.DTAG.DE"><rv@NIC.DTAG.DE></a> wrote:
</pre>
<blockquote type="cite">
<pre wrap="">Dear Johan,
thanks a lot for the new much more transparent mode of software
version management for the RIPE data base service.
This is a huge improvement.
Nevertheless I think that we need continued discussion in the community to
improve mutual understanding of considerations and impact.
Your message today brings up few consideratiosn from me
(a bit more tuned to the general pro cess than the specific case).
</pre>
<blockquote type="cite">
<pre wrap="">We were recently made aware of some issues with the documentation
related to the REST API. To fix these issues requires a new release of
the Database software as some parts of the documentation are generated
from the active code. The documentation is vital for anyone wanting to
use the service. We therefore believe it is necessary to make a new
release containing this fix only and deploy it directly to production
later today.
</pre>
</blockquote>
<pre wrap="">The problem description does NOT read like there IS ACTUAL SERVICE IMPACT
at the moment; looking at the RIPE NCC service status page seems to confirm
since it reports "no known problems" and no ser vice announcements either.
Doing a software version change with less than a day advance notice certainly
can be appropriate as an "emergency update" to deal with some service impact.
How much harm is done if fix to the documentation is done a few days later
while a note is posted indicating that certain errors will be fixed
in the near future... ?
</pre>
<blockquote type="cite">
<pre wrap="">In this particular case we don=92t believe it is necessary to put the
release in test beforehand. The only fix is for the documentation and
this is preventing users form using the service, so it's quite urgent.
This fix should have no impact on any other part of the RIPE Database
service.
</pre>
</blockquote>
<pre wrap="">I am tempted to believe your assessment; I dont have access to the changes
and the resources to do my own full assessment.
As I did experience 3 service impacting bugs within 12 months with
UNannounced version changes I conclude that I rather see than believe.
I certainly do see a need to watch more carefully how software behaves
after ANY change and a non zero probability of some surprise
(that could result in service impact for me).
Note: knowing the schedule of upcoming changes some time in advance
can be more important than actually having the ability to run tests
(like due to IETF timing I could not run tests against the test server with
1.67.4 - but we did schedule preparation of critical production runs in
a way that protected us against potential surprises due to the software change.)
</pre>
<blockquote type="cite">
<pre wrap="">If you have any questions then please let us know.
Kind regards,
Johan =C5hl=E9n
Assistant Manager Database
RIPE NCC=
</pre>
</blockquote>
<pre wrap="">Best regards,
Ruediger
Ruediger Volk
Deutsche Telekom AG -- Internet Backbone Engineering
E-Mail: <a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:rv@NIC.DTAG.DE">rv@NIC.DTAG.DE</a>
</pre>
</blockquote>
</blockquote>
</blockquote>
<br>
</div>
</blockquote>
</div>
<br>
</blockquote>
<br>
</div>
</blockquote></div><br></body></html>