[m-dev.] for review: quickcheck user guide
Ralph Becket
rbeck at microsoft.com
Sat Feb 24 04:45:04 AEDT 2001
Just a couple of comments on the typesetting of the tutorial...
* Wrapping everything in <pre></pre> tags makes reading it quite hard
on the eyes; it's generally better to leave ordinary prose unadorned
so that viewers can read it using their preferred font according to their
browser settings.
* Preformatted text *is* ideal for source code, but it's not clear to
me what the distinction is between the stuff with a different background
colour (attractive, easy to read) and the stuff in bold (horrible!) -
which is typeset using <h4></h4>, this being an abuse of HTML.
It'd be much better (and more appropriate) to just use <pre></pre>
around those sections.
* "Next Page" and "Previous Page" buttons on each page would be nice,
in addition to "Back to main". For bonus points have them at the top
*and* bottom of every page, separated from the main body of the text
with <hr>.
--
Ralph Becket | MSR Cambridge | rbeck at microsoft.com
--------------------------------------------------------------------------
mercury-developers mailing list
Post messages to: mercury-developers at cs.mu.oz.au
Administrative Queries: owner-mercury-developers at cs.mu.oz.au
Subscriptions: mercury-developers-request at cs.mu.oz.au
--------------------------------------------------------------------------
More information about the developers
mailing list