powa-team/powa

Warning in README looks outdated

guettli opened this issue · 6 comments

README:

WARNING !!!
The current version PoWA is designed for PostgreSQL 9.4 and later.
If you're using PostgreSQL 9.3, you should use PoWA version 1.x:

this looks outdated. 9.4 was release 2014 (7 years ago)

rjuju commented

Actually this repository's purpose is now only to host the documentation.

But the information is still correct, powa 2.x and all versions above only works for postgres 9.4+ as they require the queryid to be exposed in pg_stat_statements (postgres/postgres@91484409bdd to be precise), and are still compatible with all versions including 9.4.

Powa 1.x can probably still be used for pg9.3 and below, but there are so few features in that version that I doubt anyone would now be interested (assuming anyone would be willing to still run a 9.3 version in production in 2021).

But maybe it would be worth to add a statement saying that the project is still active and used with recent versions of postgres? When I saw 9.4, I also had this false impression that it was outdated :)

rjuju commented

Well the readme says

The current version PoWA is designed for PostgreSQL 9.4 and later.

Doesn't "9.4 and later" imply that the project is still active and works with recent versions? I'd be happy to improve the wording if you have a suggestion to make it more obvious, as long as it clear that it's compatible with all versions starting with 9.4.

It does. But it's all about impression management :) I would suggest adding: "up to 13" or even 14 if you run it already.

rjuju commented

We already support version 15 (the current development version). My biggest fear is that I'll forget to bump the README every year, and if that happens then the project will look abandoned and not supporting the latest versions.

How about instead rephrasing to something like that?

The current version PoWA is designed for all PostgreSQL down to 9.4.

rjuju commented

I finally pushed a clarification in the readme. Thanks again!