Re: [DOCS] A user report of misinterpretation of 'unsupported versions'
On Thu, Jul 11, 2013 at 1:03 AM, Daniel Farina wrote: > I had a report from a user asking how they could VACUUM in the future > under 9.3, when it's no longer supported (which took me aback). He > referred me to a manual page: > > http://www.postgresql.org/docs/current/static/sql-vacuum.html > > I realized, then, that the problem is the wordsmithing of: > > "This page in other versions: 9.2 / 9.1 / 9.0 / 8.4 | Unsupported > versions: 9.3 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / devel" > > An entirely reasonable person would decide that the VACUUM command is > unsupported in any of the itemized versions. Strictly speaking, *everything in 9.3 is unsupported. Because it hasn't been released yet. But I can understand the confusion - do you have a suggestion for how to write it to make it more obvious what the actual problem is? -- Magnus Hagander Me: http://www.hagander.net/ Work: http://www.redpill-linpro.com/ -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] A user report of misinterpretation of 'unsupported versions'
On 7/12/13 6:28 AM, Magnus Hagander wrote: > "This page in other versions: 9.2 / 9.1 / 9.0 / 8.4 | Unsupported >> versions: 9.3 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / devel" "This page in other versions: 9.2 / 9.1 / 9.0 / 8.4 | Devel: 9.3 | EOL: 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1" Although EOL is very much jargon. -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] A user report of misinterpretation of 'unsupported versions'
On Fri, Jul 12, 2013 at 3:28 AM, Magnus Hagander wrote: > > On Thu, Jul 11, 2013 at 1:03 AM, Daniel Farina wrote: > > I had a report from a user asking how they could VACUUM in the future > > under 9.3, when it's no longer supported (which took me aback). He > > referred me to a manual page: > > > > http://www.postgresql.org/docs/current/static/sql-vacuum.html > > > > I realized, then, that the problem is the wordsmithing of: > > > > "This page in other versions: 9.2 / 9.1 / 9.0 / 8.4 | Unsupported > > versions: 9.3 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / devel" > > > > An entirely reasonable person would decide that the VACUUM command is > > unsupported in any of the itemized versions. > > Strictly speaking, *everything in 9.3 is unsupported. Because it > hasn't been released yet. > > But I can understand the confusion - do you have a suggestion for how > to write it to make it more obvious what the actual problem is? I don't think I communicated the problem right. Or maybe I did, but I can't tell from the response. So, forgive me for hashing it again in another way. The problem is the thinking process goes like this: I'm sitting on a page about VACUUM, and here's a bit of text itemizing what versions VACUUM exists in. But here's a bit of text saying that VACUUM isn't supported (read to mean: non-existent) in [7.1,8.3] + 9.3. The thing the user was being led to believe was that VACUUM was undergoing deprecation. In other words, he chose to tighter-bind the supported/unsupported to the topic of the page, rather than the status of the entire release. -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] A user report of misinterpretation of 'unsupported versions'
Daniel Farina writes: > On Fri, Jul 12, 2013 at 3:28 AM, Magnus Hagander wrote: >> But I can understand the confusion - do you have a suggestion for how >> to write it to make it more obvious what the actual problem is? > I don't think I communicated the problem right. Yeah, you did, but we need a concrete suggestion as to how to improve the wording. I wonder if just adding "in" would help: This page in other versions: 9.2 / 9.1 / 9.0 / 8.4 | In unsupported versions: 9.3 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / devel Another possibility is to replace "unsupported" with something more explicit: This page in other versions: 9.2 / 9.1 / 9.0 / 8.4 | Unreleased or obsolete versions: 9.3 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / devel regards, tom lane -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] A user report of misinterpretation of `unsupported versions`
-BEGIN PGP SIGNED MESSAGE- Hash: RIPEMD160 > "This page in other versions: 9.2 / 9.1 / 9.0 / 8.4 | Unsupported > versions: 9.3 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / devel" > > An entirely reasonable person would decide that the VACUUM command is > unsupported in any of the itemized versions. How about we simply list all versions, without classifying them as unsupported or not? Not sure how useful our scolding^H^Hinforming people that 7.4 is old and unsupported is on a page about vacuuming. - -- Greg Sabino Mullane g...@endpoint.com g...@turnstep.com End Point Corporation 610-983-9073 PGP Key: 0x14964AC8 201307122200 http://biglumber.com/x/web?pk=2529DF6AB8F79407E94445B4BC9B906714964AC8 -BEGIN PGP SIGNATURE- iEYEAREDAAYFAlHgtO8ACgkQvJuQZxSWSshI2wCg1Gt3u8LZ312SRqBH6k9mPAwF hv8AoMShMaEHUta807dkGLO8H3FOjtey =BDnQ -END PGP SIGNATURE- -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] A user report of misinterpretation of `unsupported versions`
On Fri, Jul 12, 2013 at 9:01 PM, Greg Sabino Mullane wrote: > > > How about we simply list all versions, without classifying them as > unsupported or not? > Is there an automated mechanism by which a version would move from the 'supported' group to the 'unsupported' group, eg, when 8.4 goes EOL? Perhaps it would be more clear to first identify what version this page covers, then provide the equivalent links to other versions, such as: This page is for PostgreSQL version 9.2 For the equivalent page in other versions see: Currently Supported Versions: 9.1, 9.0, 8.4 Unreleased or Development versions: 9.3, Devel Older releases that are no longer being maintained: 8.3, 8.2, 8.1, 8.0 -- Mike Nolan
