From: Jonathan Corbet <corbet@lwn.net>
To: "Darrick J. Wong" <darrick.wong@oracle.com>
Cc: xfs <linux-xfs@vger.kernel.org>, linux-doc@vger.kernel.org
Subject: Re: [PATCH] docs: improve readability for people with poorer eyesight
Date: Sun, 7 Oct 2018 08:52:37 -0600 [thread overview]
Message-ID: <20181007085237.6281983e@lwn.net> (raw)
In-Reply-To: <20181005010603.GA6702@magnolia>
On Thu, 4 Oct 2018 18:06:03 -0700
"Darrick J. Wong" <darrick.wong@oracle.com> wrote:
> o 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>
I've been wanting to find some time to work on our stylesheets for years;
what we have now is far from ideal (or attractive) IMO. This is a good
step in the right direction - applied, thanks.
jon
prev parent reply other threads:[~2018-10-07 22:00 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
2018-10-07 14:52 ` Jonathan Corbet [this message]
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=20181007085237.6281983e@lwn.net \
--to=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).