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

Looks good and *is* much more readable than the current version on the site.

I would suggest (in a bid to make even more readable) that we indent
the paragraphs so that its clear under which heading the content is.

For instance I find the section on Binary Distributions a lot easier
to read because of the indentation introduced by the list.

just my 2c

- Martin -


On Sun, Jun 17, 2012 at 10:48 AM, Magnus Hagander <magnus@hagander.net> wrote:
> 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/
>
> --
> Sent via pgsql-www mailing list (pgsql-www@postgresql.org)
> To make changes to your subscription:
> http://www.postgresql.org/mailpref/pgsql-www