Mailing-List: contact forrest-dev-help@xml.apache.org; run by ezmlm
Precedence: bulk
Reply-To: forrest-dev@xml.apache.org
Message-ID: <3EC41729.7050705@medata.com>
Date: Thu, 15 May 2003 15:39:37 -0700
From: Clay Leeds <cleeds@medata.com>
Organization: Medata, Inc.
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US;
 rv:1.4b) Gecko/20030507
MIME-Version: 1.0
To: forrest-dev@xml.apache.org
Subject: Improving FAQ readability on FOP/faq.html
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit

I posted this to the FOP-DEV list and they recommended I post it here 
instead...

I've noticed that the TOC for the FAQ page is hard to read:

http://xml.apache.org/fop/faq.html

(perhaps others have noticed this too?). I figure, that if you remove 
the hyperlink to the numbered items (leaving the links for their 
sub-items), it'll probably improve readability:

* 1. General Questions (<-- remove this hyperlink)
      o What is FOP? (<-- leave these hyperlinks)
      o What can I do with FOP? (<-- leave these hyperlinks)
      ... (<-- leave these hyperlinks)
* 2. Problems running FOP (<-- remove this hyperlink)
      o yata yata (<-- leave these hyperlinks)

It might also help to put a space-before="6pt" for each of those 
numbered items.

In addition, is there a reason that the "ordered" list items are 
preceded by an "unordered" "bullet"? (see above)? It seems like it could 
be removed.
-- 
Clay Leeds - cleeds@medata.com
Web Developer - Medata, Inc. - http://www.medata.com
PGP Public Key: https://mail.medata.com/pgp/cleeds.asc