Re: Allow <info> as root element?

Thomas Schraitle <[email protected]> Wed, 30 Nov 2022 11:54:59 +0100
Newsgroups gmane.text.docbook.misc
Message-ID <[email protected]>
Hi,

On 30.11.22 00:48, Richard Hamilton wrote:
> I=E2=80=99ve run into the same thing. I have a separate file for our boo=
k info, so that I can move the copyright page to the back of the book for =
ebooks.
>
> I am lazy, however, and just ignore the errors when I=E2=80=99m editing =
the info page:-). I essentially do what Norm mentioned; that is, only pay =
attention to validation when the block is included in a book.

That's possible and probably all okay for your use case. But I think this =
is a
bit dangerous territory as it isn't suitable as a general practice. It cre=
ates
the wrong attitude. ;)

It might be totally okay for a single person if you are working on your ow=
n.
However, I don't think it would be okay for a group of writers. I can't sa=
y:
"Validation is king. Trust it. But ignore it here." Soon nobody trusts (or
wants) validation anymore.

IMHO, this is not a real technical issue (which could be theoretically sol=
ved
by adding <info> to the list of start elements) but I suppose it's more of=
 a
psychological factor. I fear, it would in a way undermine the trust of our
toolchain. Plus it creates some more burden on writers to dissect when to
ignore errors and when not.


> The other thing you could do, if you=E2=80=99re using xinclude, is to pu=
t the info block into a valid root element, so you can validate it, then u=
se xinclude to include just the info element when you build a deliverable.

Yes, technically possible, but still a restriction. Additionally, I'm forc=
ed to
add an XPointer expression into the <xi:include> element just to select th=
e
info. Sounds like a detour to me. :)


> I=E2=80=99m not sure how doable that is with assemblies.

That's why I wrote another post (see "State of topic oriented writing in
DocBook?") which reflects on this part. I hope it's not considered as a ra=
unchy
rant. ;)


=2D-
Gru=C3=9F/Regards
   Thomas Schraitle