From owner-freebsd-doc@FreeBSD.ORG Mon Jun 30 03:39:58 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id DED4ADCB for ; Mon, 30 Jun 2014 03:39:58 +0000 (UTC) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "wonkity.com", Issuer "wonkity.com" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 8A5142520 for ; Mon, 30 Jun 2014 03:39:58 +0000 (UTC) Received: from lightning.wonkity.com (lightning.wonkity.com [10.0.0.8]) by wonkity.com (8.14.9/8.14.9) with ESMTP id s5U3dmFS063245 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Sun, 29 Jun 2014 21:39:48 -0600 (MDT) (envelope-from wblock@lightning.wonkity.com) Received: from lightning.wonkity.com (localhost [127.0.0.1]) by lightning.wonkity.com (8.14.9/8.14.9) with ESMTP id s5U3dmXq020673 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Sun, 29 Jun 2014 21:39:48 -0600 (MDT) (envelope-from wblock@lightning.wonkity.com) Received: from localhost (wblock@localhost) by lightning.wonkity.com (8.14.9/8.14.9/Submit) with ESMTP id s5U3dlxQ020666; Sun, 29 Jun 2014 21:39:47 -0600 (MDT) (envelope-from wblock@lightning.wonkity.com) Date: Sun, 29 Jun 2014 21:39:47 -0600 (MDT) From: Warren Block To: freebsd-doc@freebsd.org Subject: Re: appearance in HTML Message-ID: User-Agent: Alpine 2.11 (BSF 23 2013-08-11) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [10.0.0.1]); Sun, 29 Jun 2014 21:39:48 -0600 (MDT) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 30 Jun 2014 03:39:58 -0000 Erich Dollansky wrote: > I would keep it and I would keep it as bold. I would only recommend a > consequent use of it. Using bold helps to find important locations a > bit faster without reading the whole sentence. ... > The moment the highlighting will only be used for the application and > not for the manufacturer, it will be very helpful for the reader. Sorry, I missed this message until posting the link to the thread in the commit message. A problem with highlighting in general is that too much of it hides detail. Some sections of our documents look like "poison pen" letters due to all the highlighting. For now, let's try letting application names just be pointed out by capital letters. If that does not work, we can try something else.