From owner-freebsd-doc@FreeBSD.ORG Mon Jun 30 04:46:20 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 0E9D6D7 for ; Mon, 30 Jun 2014 04:46:20 +0000 (UTC) Received: from alogt.com (alogt.com [69.36.191.58]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id D44902A46 for ; Mon, 30 Jun 2014 04:46:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=alogt.com; s=default; h=Content-Transfer-Encoding:Content-Type:MIME-Version:References:In-Reply-To:Message-ID:Subject:Cc:To:From:Date; bh=SdyBkpn2TuKdGPtZDS538ABEEMNttROF2knGAcP/0Yg=; b=mgAW2e91wHxjdeB7noFuiix+1FhU/a2kn4LWvM9G2RHYRyB5mC/GJo++J6Tz3yU94/kID8dPlVYk6wj1KCgMSLyMuOzMLI6rQUJ+qoKhSjyFtm9mwOuH/vIhnX83cb8OtfSuZlb2PT8tFlY/tY1g/DyfmoDM23/ZkfMChsAs5lk=; Received: from [182.0.3.227] (port=65130 helo=X220.alogt.com) by sl-508-2.slc.westdc.net with esmtpsa (SSLv3:DHE-RSA-AES128-SHA:128) (Exim 4.82) (envelope-from ) id 1X1TTo-000YC0-Jh; Sun, 29 Jun 2014 22:46:13 -0600 Date: Mon, 30 Jun 2014 12:46:05 +0800 From: Erich Dollansky To: Warren Block Subject: Re: appearance in HTML Message-ID: <20140630124605.7e08b705@X220.alogt.com> In-Reply-To: References: X-Mailer: Claws Mail 3.10.1 (GTK+ 2.24.22; amd64-portbld-freebsd10.0) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - sl-508-2.slc.westdc.net X-AntiAbuse: Original Domain - freebsd.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - alogt.com X-Get-Message-Sender-Via: sl-508-2.slc.westdc.net: authenticated_id: erichsfreebsdlist@alogt.com X-Source: X-Source-Args: X-Source-Dir: Cc: freebsd-doc@freebsd.org 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 04:46:20 -0000 Hi Warren, On Sun, 29 Jun 2014 21:39:47 -0600 (MDT) Warren Block wrote: > 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. > do not worry about this. > 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. This is the negative side effect. > > 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. We will see the result and the comments soon. Erich