pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Guillaume Lelarge <guillaume@lelarge.info>
To: Dave Page <dpage@postgresql.org>
Cc: PostgreSQL www <pgsql-www@postgresql.org>
Cc: pgsql-docs@postgresql.org
Subject: Re: [DOCS] Version differences
Date: Fri, 10 Aug 2007 22:45:58 +0200
Message-ID: <46BCCE86.4070102@lelarge.info> (raw)
In-Reply-To: <46BC6812.1050808@postgresql.org>
References: <46BC6812.1050808@postgresql.org>

Dave Page a écrit :
> There is currently no way for a visitor to the website to what whats
> cool and new in the latest major release. This info is in the main
> announcement panel for a while after we release, but is gone as soon as
> we have a conference or something.
> 
> Any ideas how we can best fix this?
> 

I think we need to keep both. As soon as a conference is coming (say a 
week before), put a note about it on the announcement panel. When the 
conference is over, put the previous note (the latest major release one) 
on the announcement panel.

I don't think we have enough place to put the two of them.

> Related to this, we have links on the front page to the release notes of
> the latest point releases. A suggestion was made to me that these should
> point to lists of all the changes in the given branch. Consider the
> following scenario:
> 
> - Critical security issue is found so we produce a release.
> - Shortly after we find a simple bug in say, plpgsql that warrants
> another release.
> - User visits the site, and only sees the details of the bug which
> doesn't affect him, thus doesn't bother to upgrade.
> 
> One solution (which could also resolve an issue that I think JD raised
> recently) would be to split the Release Notes appendix in the docs into
> seperate pages for each major release, re-ordered so the next/previous
> links make more sense. On the website we'd then point people at these
> index pages, rather than the specific release.
> 

If you really want to do this, best is to use the HTML files and modify 
them with a bunch a sed/awk/perl/bash scripting. Changing DSSSL 
stylesheets to build a really specific "release notes' manual" would be 
too hard, I guess.

Regards.


-- 
Guillaume.
http://www.postgresqlfr.org
http://docs.postgresqlfr.org



view thread (13+ messages)  latest in thread

Message-ID: <46BCCE86.4070102@lelarge.info>
Permalink:  ../46BCCE86.4070102@lelarge.info/
Also on:    postgresql.org/message-id/46BCCE86.4070102@lelarge.info

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: guillaume@lelarge.info, dpage@postgresql.org, pgsql-www@postgresql.org
  Subject: Re: [DOCS] Version differences
  In-Reply-To: <46BCCE86.4070102@lelarge.info>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox