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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.