[ZWeb] Documentation Index

Martijn Pieters mj@digicool.com
Mon, 18 Dec 2000 17:00:00 +0100


On Mon, Dec 18, 2000 at 10:13:22AM -0500, Andrew Sawyers wrote:
> The new documentation index has been made live.

Cool, it is very informative, once you puzzle out the contents..

The format is somewhat confusing; there is hardly any linespace between the
status of one item, and the listing of the next item. The effect is
slightly stronger in IE, but also present in Netscape.

An ASCII illustration (use fixed size font):

 Administrators         New Users            Web Site
                                            Developers
Administrator's      Zope Book:        
Guide                Introducing Zope     The Zope Book

Status: Incomplete   Status: Up to date   Status: Complete
Installation         Zope Tutorial        rough draft,
How-Tos                                   covers Zope 2.3
                     Status: Up to date,  Web Site
		     in online help at    Developer
		     ZopeTutorial         How-Tos
		     Online Help

		     Status: Up to date,
		     in online help at
		     ZopeHelp
		     New User How-Tos

Note that the 'Status: Incomplete' line for example, seems to belong to
the Installation How-Tos.

With a better table design and maybe some color coding (greenish for
complete, redlike for incomplete?) this could be made much clearer. Also
look into playing with font-sizes and italics.

-- 
Martijn Pieters
| Software Engineer  mailto:mj@digicool.com
| Digital Creations  http://www.digicool.com/
| Creators of Zope   http://www.zope.org/
---------------------------------------------