From: Dave Chinner <david@fromorbit.com>
To: "Darrick J. Wong" <darrick.wong@oracle.com>
Cc: corbet@lwn.net, xfs <linux-xfs@vger.kernel.org>,
linux-doc@vger.kernel.org
Subject: Re: [PATCH] docs: improve readability for people with poorer eyesight
Date: Sat, 6 Oct 2018 10:45:31 +1000 [thread overview]
Message-ID: <20181006004531.GL12041@dastard> (raw)
In-Reply-To: <20181005010603.GA6702@magnolia>
On Thu, Oct 04, 2018 at 06:06:03PM -0700, Darrick J. Wong wrote:
> Hi,
>
> So my eyesight still hasn't fully recovered, so in the meantime it's
> been difficult to read the online documentation. Here's some stylesheet
> overrides I've been using to make it easier for me to read them:
> https://djwong.org/docs/kdoc/index.html
>
> ---
> From: Darrick J. Wong <darrick.wong@oracle.com>
>
> My eyesight is not in good shape, which means that I have difficulty
> reading the online Linux documentation. Specifically, body text is
> oddly small compared to list items and the contrast of various text
> elements is too low for me to be able to see easily.
>
> Therefore, alter the HTML theme overrides to make the text larger and
> increase the contrast for better visibility, and trust the typeface
> choices of the reader's browser.
>
> For the PDF output, increase the text size, use a sans-serif typeface
> for sans-serif text, and use a serif typeface for "roman" serif text.
>
> Signed-off-by: Darrick J. Wong <darrick.wong@oracle.com>
This fixes problems I noticed when trying to review the built html
documentation - the inconsistent font sizes on my high-dpi monitor
made it almost impossible to read even though I have no eyesight
problems....
Acked-by: Dave Chinner <dchinner@redhat.com>
-Dave.
--
Dave Chinner
david@fromorbit.com
next prev parent reply other threads:[~2018-10-06 7:46 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-10-05 1:06 [PATCH] docs: improve readability for people with poorer eyesight Darrick J. Wong
2018-10-06 0:45 ` Dave Chinner [this message]
2018-10-07 14:52 ` Jonathan Corbet
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20181006004531.GL12041@dastard \
--to=david@fromorbit.com \
--cc=corbet@lwn.net \
--cc=darrick.wong@oracle.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-xfs@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).