Re: [dita] Phase 1 proposal: expand howtoavoid

If you’re going to add p you might as well add div too. I could also see an argument for dl as an alternative to simpletable.

Cheers,

Eliot Kimber

http://contrext.com

From: <dita@lists.oasis-open.org> on behalf of Dawn Stevens <dawn.stevens@Comtech-serv.com>
Date: Tuesday, May 15, 2018 at 10:47 AM
To: "dita@lists.oasis-open.org" <dita@lists.oasis-open.org>
Subject: [dita] Phase 1 proposal: expand howtoavoid

From our discussion today, I’ve put together a Phase 1 proposal for expanding the content model within <howtoavoid>.

I’ve never written a Phase 1 proposal. Hopefully I have put what is needed in it, but if I need more, please advise.

Thanks,

Dawn

Phase 1 proposal: Add elements to <howtoavoid>

Requirement:

An important requirement when writing hazard statements that conform to ISO and ANSI requirements is providing information on how to avoid the potential hazard. Often there are multiple ways to avoid the problem; however, there are currently limited elements available to itemize these ways. Users are forced to use <sl> to provide multiple lines of content and adjust their stylesheets to add bullets or other distinguishing formatting.

We need to provide additional block elements in the model to make it easier to include multiple ways to avoid.

Proposal:

The current model for <howtoavoid> content is:

<!ENTITY % hazard.cnt
  "#PCDATA |
   %basic.ph; |
   %sl; |
   %simpletable;"
>

I propose adding p, ol, and ul at a minimum to this model.

<!ENTITY % hazard.cnt
  "#PCDATA |
   %basic.ph; |
   %p; |

%sl; |

   %ul; |
   %ol; |
   %simpletable;"
>

dita message