Re: Proposed HTML Documentation Styles - Mailing list pgsql-docs

From Pavel Stehule
Subject Re: Proposed HTML Documentation Styles
Date
Msg-id CAFj8pRApOj3TNhjgN_OuuVdwAm0JUeNsZkCMh8FxcP3-01BKEw@mail.gmail.com
Whole thread Raw
In response to Proposed HTML Documentation Styles  ("Jonathan S. Katz" <jkatz@postgresql.org>)
Responses Re: Proposed HTML Documentation Styles  (Alvaro Herrera <alvherre@2ndquadrant.com>)
Re: Proposed HTML Documentation Styles  ("Jonathan S. Katz" <jkatz@postgresql.org>)
List pgsql-docs


čt 4. 10. 2018 v 17:50 odesílatel Jonathan S. Katz <jkatz@postgresql.org> napsal:
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

When I am going to document, then I see (about 0.5 sec) big PostgreSQL logo. It is not pleasant effect.

I don't like table style - middle vertical line is too black

Used colour palette is maybe too red based.

All my notes are subjective, just my feeling

Regards

Pavel



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

pgsql-docs by date:

Previous
From: "Jonathan S. Katz"
Date:
Subject: Proposed HTML Documentation Styles
Next
From: Alvaro Herrera
Date:
Subject: Re: Proposed HTML Documentation Styles