Subject: Re: What's New
From: Simon Riggs <simon@2ndquadrant.com>
To: Magnus Hagander <magnus@hagander.net>
Cc: pgsql-www@postgresql.org
In-Reply-To: <20080418113844.28cdf7b4@mha-laptop>
References: <1208340397.4259.63.camel@ebony.site>
	<20080418113844.28cdf7b4@mha-laptop>
Content-Type: text/plain
Date: Fri, 18 Apr 2008 10:55:05 +0100
Message-Id: <1208512505.4259.429.camel@ebony.site>
Mime-Version: 1.0
Content-Transfer-Encoding: 7bit

On Fri, 2008-04-18 at 11:38 +0200, Magnus Hagander wrote:
> Simon Riggs wrote:
> > We need a way to link to the release notes for the latest production
> > release, so people can easily see What's New.
> > 
> > 1. Currently its very hard to locate a description of what the new
> > features in the latest release are. You have to know how the docs are
> > structured to find it easily. If you click on the Home Page's "Notes"
> > link for 8.3.1 you go to the minor release notes for 8.3.1 and there
> > is no obvious link to the notes for 8.3.0 which is where all the main
> > features are described. We don't even say that's how it works, so
> > there's no way of knowing you aren't viewing *all* the info. So if you
> > don't know, and most people don't, 8.3 looks like a minor upgrade from
> > 8.2 only, so why bother.
> 
> Good point. But we need some way to include the release notes for the
> minor version as well. Do you have any suggestion for how to do it?
> Adding two different set of notes to the website there will just make
> things even more confusing, I think. 

> Perhaps what we need is a section
> in the 8.3.1 release notes that says "this is a minor update. If you
> want to see the release notes between 8.2 and 8.3, please click here"
> with a link to them?

Good idea.

Wording: "This is a minor release. For a full list of features added in
this major release, please click here".

Note that this would be a link between *any* minor release and its
corresponding major release. i.e. 8.3.1, 8.3.2 etc would all point to
8.3

> > 2. There's no permanent URL for What's New in the latest release, so
> > people that put links to us externally need to continually update
> > their links. Google's What's New link points to 8.2 release notes. I
> > could contact them and say "Hey Google, you're wrong" but ISTM the
> > best way is for us to provide a permanent URL that we can then link
> > to from Google and our own home page. Then we only need to ask them
> > to do this once.
> 
> This we can do, once we can decide what it should point to per your
> first point. 
> 
> But can we actually somehow control what google chooses to link to? I
> mean, if they detect our redirect and just link directly to the page it
> points to, we're right back at the same point. Or if they index them as
> separate pages, we'd want to make sure we get the right one.
> 
> On the same tack, I've been trying to figure out if there is  away to
> make google prefer the latest version of our docs whe nyou search for
> something. Now you often get hits in 7.4.. Like a way to prioritize it.
> Anybody know if there is a way to do that?

I think: talk to Google. But no point until we have our house in order.

-- 
  Simon Riggs
  2ndQuadrant  http://www.2ndQuadrant.com