This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: Highlights vs. Abstract
- From: Norman Walsh <ndw at nwalsh dot com>
- To: Joachim Ziegler <ziegler at mpi-sb dot mpg dot de>
- Cc: "docbook at lists dot oasis-open dot org" <docbook at lists dot oasis-open dot org>
- Date: Fri, 31 Jan 2003 07:51:20 -0500
- Subject: DOCBOOK: Re: Highlights vs. Abstract
- References: <3E3A517A.2010300@mpi-sb.mpg.de>
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
/ Joachim Ziegler <ziegler@mpi-sb.mpg.de> was heard to say:
| I'm just wondering what the difference is and when I should use which
| tag. Can somebody explain to me or give a good example?
Sigh. Highlights exists because in the DocBook V1 days one of the most
important use cases was the X11 reference set. Those books had a
"highlights" section at the beginning of each chapter that discussed
what was going to be in the chapter. This was independent of a one or
two paragraph abstract.
Chances are, if you are going to start your chapter with a "here's
what we'll cover in this chapter", it belongs in the highlights.
Abstracts are not always presented, they're metadata. Highlights
aren't metadata, they're part of the chapter.
Be seeing you,
norm
- --
Norman Walsh <ndw@nwalsh.com> | The human race consists of the
http://www.oasis-open.org/docbook/ | dangerously insane and such as are
Chair, DocBook Technical Committee | not.--Mark Twain
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>
iD8DBQE+OnFIOyltUcwYWjsRAtGUAJ0W5Ow/opKroOa3WDBp+AIMXsqBEwCeORvs
22Zhou75Lm+mxyQNU2LvmpE=
=bDIa
-----END PGP SIGNATURE-----