Re: Proposed HTML Documentation Styles

From: Dean Rasheed <dean(dot)a(dot)rasheed(at)gmail(dot)com>
To: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org, Sarah Conway Schnurr <xenophenes42(at)gmail(dot)com>
Subject: Re: Proposed HTML Documentation Styles
Date: 2018-10-14 10:49:35
Message-ID: CAEZATCXJNswQky7LZNOtFPNndBn-2HtstQQz+gvKmcg_ubxHNA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Fri, 12 Oct 2018 at 03:03, Jonathan S. Katz <jkatz(at)postgresql(dot)org> wrote:
> On 10/11/18 3:01 AM, Dean Rasheed wrote:
> > On Thu, 11 Oct 2018 at 06:49, Dean Rasheed <dean(dot)a(dot)rasheed(at)gmail(dot)com> wrote:
> >> For example, attached are screenshots taken from my Android tablet
> >
> > For the record, that was a Samsung Galaxy Tab S2 8.0, with a screen
> > resolution of 2048x1536 and a device pixel ratio of 2.0, I think. So
> > the logical resolution is 1024x768, and in portrait mode, the logical
> > width is 768 pixels.
>
> Unfortunately HTML tables are not great in mobile web. With that said,
> we pushed up a change that should keep them from exploding as much to
> the right. We've also bumped up the font-size slightly from the current
> site so they could be slightly easier to read.
>
> (Note: when testing in the browser, they appear to be illegible unless
> you have super vision, but when on an actual device they are legible).
>
> There is only so much we can do now without redesigning how the tables
> are assembled.
>

Indeed. It's probably unrealistic to try to support really small
devices. I mentioned that particular one because there was a clear
regression from the old style. I have re-tested it and now it's much
better, so thanks for the fix.

Arguably, the font scaling in the @media CSS is now a little too
aggressive. IMO 60% rather than 50% is a little more readable for the
576-768px range, and 80% rather than 70% for the 769-992px range, but
that's a very subjective matter.

Regards,
Dean

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Oleg Bartunov 2018-10-14 21:14:32 bloom documentation patch
Previous Message Bruce Momjian 2018-10-14 01:01:57 Re: v11: RETURN syntax for procedure