DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=mime-version:in-reply-to:references:date:message-id:subject:from:to
	:cc:content-type;
	b=MMi/pXDLf4onMrk9KXcPexaLBtf5DK2P37Y6DVctv/YYb8qZzpo2es1h2aDwDQlt21
	WzIQ0UgqA6FElkiG+DV3vpefI5hcnomFFJcf+bWKEZ1UUC1jJQ5j5nlOYDisNoTGqnRg
	EnKDs6m5jO8WivEZ4DM+5PJL0bsoCivyiAJyA=
MIME-Version: 1.0
In-Reply-To: <201101142053.p0EKr6R18322@momjian.us>
References: <8C378959-1A31-45DB-846D-4EEFAD747CB4@doesnthaveone.com>
	<201101142053.p0EKr6R18322@momjian.us>
Date: Sat, 15 Jan 2011 08:21:29 +1100
Message-ID: <AANLkTiktjnx8oz08+LM1rvwDJCuVmuiCNeLa=Si-uOiV@mail.gmail.com>
Subject: Re: [DOCS] Documentation Navigation Feedback
From: Brendan Jurd <direvus@gmail.com>
To: Bruce Momjian <bruce@momjian.us>
Cc: Chris Meller <chris@doesnthaveone.com>,
	PostgreSQL www <pgsql-www@postgresql.org>
Content-Type: text/plain; charset=ISO-8859-1

On 15 January 2011 07:53, Bruce Momjian <bruce@momjian.us> wrote:
>
> I am forwarding this email to the www team in case there is something
> that can be done to improve our website's display of documentation:
>

I thoroughly agree with Chris' comments.  The docs have excellent
content but are somewhat unwieldly.

The navigation links at the bottom are much more useful than the ones
at the top, we might want to swap these around, or perhaps just
duplicate what's currently at the bottom to both locations.

I have never used "Fast {Back,For}ward", and after playing around with
them a bit, I still don't see the point.  Does a feature this obscure
really deserve the prime real estate it currently occupies?

I think I understand why the breadcrumbs stop at "PostgreSQL 9.0" --
the HTML docs themselves are generated from the doc sources in the
core project, but the breadcrumbs are part of the webpage container,
so they have no knowledge of the docs' internal structure.  Still, if
we could find some way to extend the breadcrumbs all the way down to
the current page, it would be a big step up in usability.

Cheers,
BJ