From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1P1S1T-0006nB-22 for garchives@archives.gentoo.org; Thu, 30 Sep 2010 22:54:44 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 04F87E0B52; Thu, 30 Sep 2010 22:53:51 +0000 (UTC) Received: from mail-fx0-f53.google.com (mail-fx0-f53.google.com [209.85.161.53]) by pigeon.gentoo.org (Postfix) with ESMTP id BC894E0B52 for ; Thu, 30 Sep 2010 22:53:50 +0000 (UTC) Received: by fxm18 with SMTP id 18so2654082fxm.40 for ; Thu, 30 Sep 2010 15:53:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:received:received :in-reply-to:references:date:message-id:subject:from:to:content-type; bh=ErSqf7FmsuX87CBonT/sFhpsHyFBqE4mjrp/SP7nvbo=; b=gDs1EO+e9BKC9NygCLaVLLH0v50RgMPOp+LLIZQfv5LmWllJkyePNudTExatZ9JoWg pMG+M+h+vQ5JFMnObOyYU8PmPt+E0w64YpqAj2MN4qfGQwWYUD7m5ZqwEN+jOPYudxAU NZrbnwg5tHXsU/roHYF9voqxsPZySm6PTgv2k= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; b=BeP1pqVgMySSkrvZIoIXWCqkq+NhufsoA7t7/59/gSAaCnJ0vqmGkt52lOuobQzTCs Ynolb0oei20zc5bZgxIqdys97jZx6Z4P0iXECiWKSYUPs4kn0A6SBaTF/3RUXjvWjV/Z V6pgYfXBZKdvcKWcJDCfE3J8RoWdeCXUSrArM= Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-user@lists.gentoo.org Reply-to: gentoo-user@lists.gentoo.org MIME-Version: 1.0 Received: by 10.223.126.11 with SMTP id a11mr4642422fas.25.1285887230182; Thu, 30 Sep 2010 15:53:50 -0700 (PDT) Received: by 10.223.117.75 with HTTP; Thu, 30 Sep 2010 15:53:50 -0700 (PDT) Received: by 10.223.117.75 with HTTP; Thu, 30 Sep 2010 15:53:50 -0700 (PDT) In-Reply-To: References: Date: Thu, 30 Sep 2010 18:53:50 -0400 Message-ID: Subject: Re: [gentoo-user] ridiculously wide handbook pages From: Jacob Todd To: gentoo-user@lists.gentoo.org Content-Type: multipart/alternative; boundary=001636c5a26d938407049181f3e8 X-Archives-Salt: 66a5b379-39b3-4d55-bbd5-ea5748368f21 X-Archives-Hash: 6c00fff1aa7d741c737ea87f37a5c7b2 --001636c5a26d938407049181f3e8 Content-Type: text/plain; charset=UTF-8 They're readable even on my droid x. On Sep 30, 2010 1:15 PM, "Grant Edwards" wrote: > I've noticed recently that the Gentoo handbook web pages are > ridiculously wide. (It seems to me that they didn't used to be, but I > wouldn't swear to that). > > For example, look at this page: > > http://www.gentoo.org/proj/en/base/embedded/handbook/?part=1&chap=2 > > The normal text paragraphs have lines that average over 160 characters > per line. The generally accepted guideline for line length in order to > maintain good readability is 40-80. The above page's lines are 2-4 > times as long as recommended for good readability, and they are in > fact so long that I can't make my browser wide enough to see an entire > line. > > Line lengths that long make the pages hard to read even if you _can_ > make your browser wide enough to show an entire line. > > The regular handbook is a little better: > > http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?full=1 > > That has lines that average about 140 characters. That's still much > longer than what I'd consider good practice. > > Do the extremely long lines in the handbook web pages bother anybody > else? > > I can understand that things like example code blocks or sample > command input/output blocks might need to be wide enough to require > horizontal scrolling of a browser window, but normal text paragraphs > with 160 characters per line? > > -- > Grant Edwards grant.b.edwards Yow! Is this going to > at involve RAW human ecstasy? > gmail.com > > --001636c5a26d938407049181f3e8 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable

They're readable even on my droid x.

On Sep 30, 2010 1:15 PM, "Grant Edwards" <grant.b.edwards@gmail.com> wrote:
> I've noticed recently that the Gentoo handbook w= eb pages are
> ridiculously wide. (It seems to me that they didn't used to be, bu= t I
> wouldn't swear to that).
>
> For example, loo= k at this page:
>
> http://www.gentoo.org/proj/= en/base/embedded/handbook/?part=3D1&chap=3D2
>
> The normal text paragraphs have lines that average over 160 c= haracters
> per line. The generally accepted guideline for line lengt= h in order to
> maintain good readability is 40-80. The above page&#= 39;s lines are 2-4
> times as long as recommended for good readability, and they are in
= > fact so long that I can't make my browser wide enough to see an en= tire
> line.
>
> Line lengths that long make the pages h= ard to read even if you _can_
> make your browser wide enough to show an entire line.
>
>= The regular handbook is a little better:
>
> http://www.ge= ntoo.org/doc/en/handbook/handbook-x86.xml?full=3D1
>
> That has lines that average about 140 characters. That's= still much
> longer than what I'd consider good practice.
>= ;
> Do the extremely long lines in the handbook web pages bother any= body
> else?
>
> I can understand that things like example code = blocks or sample
> command input/output blocks might need to be wide = enough to require
> horizontal scrolling of a browser window, but nor= mal text paragraphs
> with 160 characters per line?
>
> --
> Grant Edwar= ds grant.b.edwards Yow! Is this going to
> = at involve RAW human ecstasy? > gmail.com
>
>

--001636c5a26d938407049181f3e8--