Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 14 Mar 2013 17:33:52 -0600 (MDT)
From:      Warren Block <wblock@wonkity.com>
To:        Gabor Kovesdan <gabor@FreeBSD.org>
Cc:        doc@freebsd.org
Subject:   Re: [CFR] Migrating the documentation to a real XML toolchain
Message-ID:  <alpine.BSF.2.00.1303141642470.84119@wonkity.com>
In-Reply-To: <5142357A.9070301@FreeBSD.org>
References:  <512D2F9C.8080403@FreeBSD.org> <alpine.BSF.2.00.1302261759420.49330@wonkity.com> <5142357A.9070301@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, 14 Mar 2013, Gabor Kovesdan wrote:

> Em 27-02-2013 02:24, Warren Block escreveu:
>> Author info is a little off.  Compare the authors at the start of the 
>> bsdinstall chapter:
>> http://people.freebsd.org/~gabor/db45/en_US.ISO8859-1/books/handbook/bsdinstall.html 
>> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bsdinstall.html
>> 
>> In the standard version, each section is rendered as a sentence, with 
>> multiple authors separated by commas.
>> 
>> Acronyms don't have any highlights, they just look like normal text.
>> 
> Thank you Warren for the exhaustive list, I've been fixing the issues you 
> reported. However, I don't find highlighted acronyms in the old rendering 
> either. Could you please point me to a concrete example, please?

Good question.  I know this is given as a reason why acronyms should 
always be marked up, and I thought I'd seen it at some point in the 
FreeBSD docs.  But it does not do it now, and I may have been looking at 
something else.  It is something that would really benefit the reader.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.00.1303141642470.84119>