<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Jul 2, 2019 at 11:19 PM Matti Picus <<a href="mailto:matti.picus@gmail.com">matti.picus@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">In PR 13886 I reworked the way the link to the release notes is <br>
generated. The current page is<br>
<br>
<br>
<a href="http://www.numpy.org/devdocs/release.html" rel="noreferrer" target="_blank">http://www.numpy.org/devdocs/release.html</a><br>
<br>
<br>
and  the new page is<br>
<br>
<br>
<a href="https://8001-908607-gh.circle-artifacts.com/0/home/circleci/repo/doc/build/html/release.html" rel="noreferrer" target="_blank">https://8001-908607-gh.circle-artifacts.com/0/home/circleci/repo/doc/build/html/release.html</a><br>
<br>
<br>
I don't like the "wall of text" in the current page. On the other hand, <br>
it is nice to use CTRL-F to search the page itself for answers to <br>
questions like "what release deprecated indexing by float", which is why <br>
I left the level-of-detail at 3 (1 - release, 2 - sections, 3 - item <br>
header).<br>
<br></blockquote><div><br></div><div>That seems a good compromise - certainly I have often used CTRL-F</div><div>on release notes or change notes while tracing regressions - and having</div><div>all the releases on one page makes this *so* much easier.</div><div><br></div><div>Due to the way I typically use release notes, I would perhaps have</div><div>just left the wall of text as is.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
Should the level-of-detail be reduced to only single links to the <br>
release document?<br>
<br></blockquote><div><br></div><div>I'm unclear what you are suggesting here.</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
An alternative would be to render the contents as a collapsible list, <br>
which would require some javascript.<br><br></blockquote><div><br></div><div>Collapsible lists (which worked with CTRL-F searching) would be even</div><div>better for balancing readability with utility, provided it was not too much</div><div>trouble to implement and maintain of course.</div><div><br></div><div>Peter</div><div><br></div></div></div>