<?xml version="1.0" encoding="UTF-8" standalone="yes"?><feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en-us"><id>https://blog.pgxn.org/tags/unstable/</id><title>Unstable</title><updated>2012-04-06T17:02:19Z</updated><link rel="self" type="application/atom+xml" href="https://blog.pgxn.org/tags/unstable/feed.xml"/><link rel="alternate" type="text/html" href="https://blog.pgxn.org/tags/unstable/"/><author><name>The PGXN Maintainers</name></author><generator uri="https://gohugo.io/" version="0.167.0">Hugo</generator><entry><id>https://blog.pgxn.org/post/20596200256</id><title type="html">Only Stable Releases are Indexed</title><link rel="alternate" type="text/html" href="https://blog.pgxn.org/2012/stable-only-indexed/"/><updated>2026-10-07T16:13:48Z</updated><published>2012-04-06T17:02:19Z</published><author><name>David E. Wheeler</name></author><category scheme="https://blog.pgxn.org/tags" term="release" label="Release"/><category scheme="https://blog.pgxn.org/tags" term="status" label="Status"/><category scheme="https://blog.pgxn.org/tags" term="release-status" label="Release Status"/><category scheme="https://blog.pgxn.org/tags" term="stable" label="Stable"/><category scheme="https://blog.pgxn.org/tags" term="testing" label="Testing"/><category scheme="https://blog.pgxn.org/tags" term="unstable" label="Unstable"/><category scheme="https://blog.pgxn.org/tags" term="full-text-index" label="Full Text Index"/><category scheme="https://blog.pgxn.org/tags" term="fti" label="FTI"/><category scheme="https://blog.pgxn.org/tags" term="search-results" label="Search Results"/><category scheme="https://blog.pgxn.org/tags" term="adaptive-estimator" label="Adaptive Estimator"/><summary type="html"><![CDATA[I&rsquo;ve had a few reports over the last few months that folks uploaded new
extensions to <a href="https://pgxn.org/">PGXN</a> but they failed to show up in search results. For
example, as of right now, if you <a href="https://pgxn.org/search?q=distinct&amp;in=docs">search for &ldquo;distinct&rdquo;</a>, you get two results,
<a href="https://pgxn.org/dist/omnipitr/doc/internals.html">OmniPITR</a> and <a href="https://pgxn.org/dist/pgtap/doc/pgtap.html">pgTAP</a>. This despite the fact that the recently-released
<a href="https://pgxn.org/dist/adaptive_estimator/">adaptive_estimator</a> extension is <a href="https://pgxn.org/tag/distinct/">tagged &ldquo;distinct&rdquo;</a>. Author <a href="https://pgxn.org/user/tomasv">Tomas Vondra</a>
reported this issue, and it took me a couple of days to realize why it wasn&rsquo;t
showing up.]]></summary><content type="html" xml:base="https://blog.pgxn.org/" xml:space="preserve"><![CDATA[<p>I&rsquo;ve had a few reports over the last few months that folks uploaded new
extensions to <a href="https://pgxn.org/">PGXN</a> but they failed to show up in search results. For
example, as of right now, if you <a href="https://pgxn.org/search?q=distinct&amp;in=docs">search for &ldquo;distinct&rdquo;</a>, you get two results,
<a href="https://pgxn.org/dist/omnipitr/doc/internals.html">OmniPITR</a> and <a href="https://pgxn.org/dist/pgtap/doc/pgtap.html">pgTAP</a>. This despite the fact that the recently-released
<a href="https://pgxn.org/dist/adaptive_estimator/">adaptive_estimator</a> extension is <a href="https://pgxn.org/tag/distinct/">tagged &ldquo;distinct&rdquo;</a>. Author <a href="https://pgxn.org/user/tomasv">Tomas Vondra</a>
reported this issue, and it took me a couple of days to realize why it wasn&rsquo;t
showing up.</p>
<p>Here&rsquo;s the reason: Only &ldquo;stable&rdquo; releases are indexed. The <a href="https://pgxn.org/dist/adaptive_estimator/1.0.0/">first</a> and
<a href="https://pgxn.org/dist/adaptive_estimator/1.1.0/">second</a> adaptive_estimator releases both have their release status set to
&ldquo;testing&rdquo;. The PGXN API only indexes stable releases. The idea behind that is
that you want most folks to continue using stable releases while you work on
testing new versions. So when users search the site, only the latest stable
release will appear in search results. Similarly, installing an extension via
the <a href="https://pgxnclient.projects.postgresql.org/">PGXN client</a>, prefers the latest stable release by default. If you want
the most recent, you have to <a href="https://pgxnclient.projects.postgresql.org/usage.html#pgxn-install">specify the <code>--unstable</code> or <code>--testing</code> option</a>.</p>
<p>So, the upshot is, if you want your extension to appear in the full text
search results on the PGXN, site, release a stable version.</p>
<p>That said, I first noticed this issue a while ago, and filed <a href="https://github.com/pgxn/pgxn-api/issues/2">an issue</a> with
the idea that, if an extension is uploaded that is not stable, but there are
no stable versions, then the extension should be indexed, anyway. The idea
here is that, when you first upload it, you don&rsquo;t have any existing users to
keep on a stable release anyway, because there <em>is no stable release.</em> So
perhaps we should go ahead and index it. A non-stable release would only be
omitted from the index if there was an existing stable release.</p>
<p>Thoughts?</p>
]]></content></entry></feed>