Re: [docbook-tc] legalsection versus section in legalnotice

I think there are times where we would want the legalnotice content as metadata, and also times when the notice needs to be included in the publication. Based on this, I think we do need to allow legalnotice outside of info.

For legalsection, I would think we would want to strip out the technical inlines like:

|programlisting|programlistingco|

classsynopsis|fieldsynopsis|constructorsynopsis|

destructorsynopsis|methodsynopsis|

I'd even be willing to cut more out of the model, as this content should be pretty cut and dried legaleseâ 😊

I'd also be ok with just allowing section directly for the reuse opportunities and minimal impact to user expectations.

--Scott

From: <docbook-tc@lists.oasis-open.org> on behalf of Bob Stayton <bobs@sagehill.net>
Date: Thursday, December 6, 2018 at 1:24 PM
To: DocBook Technical Committee <docbook-tc@lists.oasis-open.org>
Subject: [docbook-tc] legalsection versus section in legalnotice

This email contains an attachment from a external source

This email contains an attachment which could be a possible security concern. Attachments can potentially contain computer viruses or malicious content. Do not open this attachment if you do not trust the source of this email.

I'm following up on my action item to continue the discussion of the content model of legalnotice to support some kind of section. I have attached the sample files that Larry sent out 23 October 2018.

We were debating whether we should allow section within legalnotice or whether we should add a new legalsection element only for legalnotice. I'll try and summarize the discussion so far.

The first question I want to ask is whether we are allowing legalnotice to appear outside of info. That would make such a legalnotice into literal content that would always be rendered in the output, as opposed to metadata in info that may or may not be rendered. I believed we discussed this possibility, for example putting several legalnotices in an appendix, but I'm not sure what we decided. That decision would seem to affect how we structure legalnotice, especially if it contains sections.

So do we intend to allow legalnotice as regular content outside of info?

If we use section within legalnotice, I don't think we resolved whether we would alter the content model when it is used inside legalnotice. That seems to be something we need to decide as it affects the arguments for and against.

For example, if we change the content model of section inside legalsection, then you could not cut and paste sections in and out of legalsection without getting validation errors. Also, users of a content-aware editor would experience restrictions in their element selection that they might not understand. If we don't change the model of section inside legalnotice, then both of these arguments no longer apply.

So, do we need to change the content model of section inside legalnotice, and if so, how?

--

Bob Stayton

Sagehill Enterprises

bobs@sagehill.net

docbook-tc message