OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

dita-techcomm message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [dita-techcomm] User on Yahoo suggests substep as a child of choice and within choicetable


Having substeps within choice would simplify documenting some complex wizards. For example, we have a series of them where we have to document the choices, followed by: if you choose this, go to Step #.

That ends up with a procedure that's very complicated to follow.


From: Bob Thomas <bob.thomas@tagsmiths.com>
Date: Thursday, December 12, 2013 7:46 AM
To: "dita-techcomm@lists.oasis-open.org" <dita-techcomm@lists.oasis-open.org>
Subject: [dita-techcomm] User on Yahoo suggests substep as a child of choice and within choicetable


This thread is interesting.

It's clear that authors utilize ordered list to achieve the desired formatting when step-like things are needed within choice and choicetable. Do we contend that having step-like things inside of choice and choicetable are not a valid use-cases? I believe that they are valid use-cases, especially when you consider that Information Mapping advocates this construct in their if-then tables.

If we agree that step-like things within choice and choicetable are valid use-cases, then it would be better to offer the semantically correct element for the use cases in choice and chdesc. I deliberately omitted choption from having substeps because I contend the choption content is to help the reader select among choices.

Ordered list would have to remain in the content model for backward compatibility. But, a newly adopting organization could remove it with a constraint.

I suspect that the current models were arrived at only after lengthy discussion. Should we decide to pursue this, it would be useful to have the rationale for the decisions.

Best Regards,

Bob Thomas
+1 720 201 8260
Skype: bob.thomas.colorado
Instant messaging: Gmail chat (bob.thomas@tagsmiths.com) or Skype
Time zone: Mountain (GMT-7)

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]