Proposed HTML Documentation Styles

From: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Cc: Sarah Schnurr <xenophenes42(at)gmail(dot)com>
Subject: Proposed HTML Documentation Styles
Date: 2018-10-04 15:50:26
Message-ID: 489cd083-d657-1137-006f-f70b803cffda@postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Hi,

As part of the effort to modernize the look and feel of PostgreSQL.org
and associated web projects, Sarah & I have worked on applying the new
styles to the documentation. The main goals of the project were:

- To have the documentation styles match that of the main website
- To make the documentation easier to view on mobile devices
- To set up the web-based documentation for future usability changes and
improvements

Other than reversing how the versions are display at the top of the
website, we did not change any of the documentation structure and do not
intend to as part of this version of the project.

We have created a prototype of the new styles that can be viewed here,
with the credentials below:

http://174.138.60.30/docs/
pgdocs / newstyles

When browsing through this site, please note:

- All interactions are confined to the "/docs" folder
- Not all of the docs are loaded and they are not all the latest
versions - this is just for beta testing purposes
- Search in the prototype does not work

We are looking for feedback in the following areas:

- Things that may have degraded the user experience, e.g. things that
are difficult to read
- Visual bugs and errors

Our goal is to launch these changes with the upcoming major release, so
we appreciate your diligence in providing helpful feedback so we can
provide the best possible experience.

Thanks,

Jonathan

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Pavel Stehule 2018-10-04 16:02:48 Re: Proposed HTML Documentation Styles
Previous Message Joe Conway 2018-10-02 12:45:37 Re: dblink_error_message return value