Some restructuring of the download section - Mailing list pgsql-www

From Magnus Hagander
Subject Some restructuring of the download section
Date
Msg-id CABUevExJ2zibPcT7VF+Zmxuz_aEu7HrHYEE5dV8uLcAeupYQgw@mail.gmail.com
Whole thread Raw
Responses Re: Some restructuring of the download section  (Dave Page <dpage@pgadmin.org>)
Re: Some restructuring of the download section  (Guillaume Lelarge <guillaume@lelarge.info>)
Re: Some restructuring of the download section  (Josh Berkus <josh@agliodbs.com>)
Re: Some restructuring of the download section  (Martin Atukunda <matlads@gmail.com>)
Re: Some restructuring of the download section  (Bjorn Munch <bjorn.munch@oracle.com>)
Re: Some restructuring of the download section  (Pierre-Emmanuel André <pea@raveland.org>)
List pgsql-www
Per discussions I've had with people for a long time now, I finally
got around to making some changes to the structure of the download
section last week, to make it a little bit less cluttered and
confusing. And I think minus a few details they're about ready to go.
And then I promptly forgot about posting it here...

So, important things first. Since it contains a lot of cut/paste
between different places the diff can be a bit hard to read. So I've
pushed a preview version of it up at
http://young-window-5672.herokuapp.com/download/. Username is webtest,
password foobar - to make sure google doesn't end up crawling it for
me...

I've pushed my development branch to github. It contains a lot of
minor changes and back/forth changes, so the history is probably not
very interested, but you can view the full diff to master at
https://github.com/mhagander/pgweb/compare/master...downloadrefactor,
or clone that github repo if you want to make some changes off it.

The main difference for people to actually see are, other than
generally trying to make it easier to read:
* Add more distinct links in the navigation bar. The Download one
becomes redundant, but it also makes it much easier to "get back" to
the starting point
* Remove the strange horizontal menu we used to select platform - it
didn't correspond to any kind of standard way of doing webpage layout,
and confused a lot of people
* Introduce a more granular split between Linux distributions, to be
able to target information more specifically - instead of a huge
if/elseif/elseif block between which distro you're on. Results in more
pages, but a lot more structured and easy to read pages.
* Put much more actual information on the per-distribution/per-os
pages. E.g. instead of "you can use yum", it has "how and why to use
yum" (and similar for other distros)
* Remove individual (and usually inconsistent) packager crediting -
this should be credited on the main project (/community/contributors/
page) like all other contributors.
* Update the snapshot download information which has been lacking love
for a long time
* In some pages, get rid of 200-char long rows and just fold them into
normal rows (e.g. the windows download page). Generates a big diff,
though...

Constructive comments are most welcome ;)

Also, I need help to update the details for operating systems/distros
and install methods that I don't know myself. I'd appreciate it if
someone who does could look at e.g. the RedHat pages and then
construct similar pages for the following OSes (either send me the
text, or just do a fork+pullreq on github):
* FreeBSD (Palle has promised to work on this alrady)
* OpenBSD (I suggest you wait until Palle is done with FreeBSD, since
I suspect they will be very similar)
* SuSE
* Mac OS X (the Fink and Macports part - I think I have the rest
covered by bugging people on IRC)
* Solaris

It's no worse than it is before, but it would be good to  be able to
improve the information on those pages as well.

--
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/


pgsql-www by date:

Previous
From: Magnus Hagander
Date:
Subject: Re: [PATCH] Cross-version navigation in documentation
Next
From: Dave Page
Date:
Subject: Re: Some restructuring of the download section