Re: RDFa Lite inside <info>

Norm Tovey-Walsh <[email protected]> Sun, 04 Jul 2021 12:53:43 +0100

Newsgroups	gmane.text.docbook.misc
Message-ID	<[email protected]>

> I'd suggest both are (eventually) for human readers, and both are 'about'
> the document?

That’s fair. There probably isn’t a general statement that I could make
about metadata or annotations for which someone couldn’t say “yes, but…”
and suggest an alternate view.

> Graffitti? Redactions? Editorial notes? Study notes? All annotations.
> That's the broader interpretation I put on annotations now.

Fine by me. I think we may be finding it all a bit slippery partly
because the English language word “annotation” is very broad. According
to Merriam-Webster, “a note added by way of comment or explanation.”

By that definition any aside, digression, note, footnote, quotation,
sidebar, figure, example, table, revision, title, annotation, or other
element might be described as “an annotation.”

DocBook <annotation> markup is a facility for making out-of-line
comments about a text. You can point from the annotation to the
annotated text, or from the annotated text to the annotation. What you
put *in* the annotations and what the annotations *mean* in the context
of *your document* is up to you!

My intuitive feeling about them is that they’re something like
footnotes, but maybe not intended for the traditional presentation of
footnotes or maybe made by a third party and so not part of the actual
document, but about it.

                                        Be seeing you,
                                          norm

--
Norman Tovey-Walsh <[email protected]>
https://nwalsh.com/

> Besides a mathematical inclination, an exceptionally good mastery of
> one's native tongue is the most vital asset of a competent
> programmer.--E. Dijkstra

signature.asc (application/pgp-signature, 832 B)