| From | Sent On | Attachments |
|---|---|---|
| Michael Priestley | Oct 9, 2009 2:06 pm | |
| Su-Laine Yeo | Oct 9, 2009 5:41 pm | |
| Ogden, Jeff | Oct 11, 2009 11:07 am | |
| Michael Priestley | Oct 13, 2009 6:53 am | |
| ekimber | Oct 13, 2009 6:57 am |
| Subject: | RE: [dita] weak/strong constraint proposal | |
|---|---|---|
| From: | Ogden, Jeff (jog...@ptc.com) | |
| Date: | Oct 11, 2009 11:07:37 am | |
| List: | org.oasis-open.lists.dita | |
I don't understand why "Constraining a document will affect copy/paste as well as conref". It might, but not in the same way or to the same extent.
It is true that copy/paste needs to be DTD valid by the time it is done, but so do other forms of editing changes. What is validated is the actual markup to be inserted. And implementations are free to make copy/paste as smart or as dumb as they wish and can, but are not required to, transform the material being pasted as necessary in an attempt to make it valid.
Conref validation is different. It isn't DTD validation and uses information from the domains and possibly the class attribute to validate potential rather than actual markup.
So copy and paste from a general task to a strict task could work depending on what markup is being moved, while conrefing the same markup from a general task into a strict task won't work (at least not for "strong" conref validation). But the same could be said for copy and paste and conref between different topic document types that use different domains and which do not use constraints.
-Jeff
From: Su-Laine Yeo [mailto:su-l...@justsystems.com] Sent: Friday, October 09, 2009 8:42 PM To: Michael Priestley; di...@lists.oasis-open.org Subject: RE: [dita] weak/strong constraint proposal
Thanks Michael. I see the value in the proposal and I don't have a specific objection to it, however to start the discussion I'll recap a couple of things I've mentioned in off-list discussions and in a previous TC meeting:
1) Constraining a document will affect copy/paste as well as conref. If you constrain out <lq> elements, for example, you won't be able to paste anything that contains a <lq> element and have it be valid. Depending on your authoring tool, it could mean not being able to paste that content at all unless you remove the <lq> element first.
If an organization's goal is to simplify the user experience for authors (by presenting a smaller element list), but they don't want to strictly disallow any structures, using constraints will be a problematic way to achieve their goal regardless of whether we adopt this proposal.
2) There are features on the DITA 1.3 list that I think are higher-priority than this proposal.
I'm open to being persuaded otherwise, but for now I think that we should focus on what is already in 1.2.
Happy Thanksgiving to the Canadians, by the way! I'll be out of the office on Monday Oct 12.
Best regards,
Su-Laine
Su-Laine Yeo Interaction Design Specialist
JustSystems Canada, Inc. Office: 778-327-6356 sy...@justsystems.com <mailto:sy...@justsystems.com>
www.justsystems.com <http://www.xmetal.com>
From: Michael Priestley [mailto:mpri...@ca.ibm.com] Sent: Friday, October 09, 2009 2:07 PM To: di...@lists.oasis-open.org Subject: [dita] weak/strong constraint proposal
The following proposal is relative to the existing constraint design documented here: http://www.oasis-open.org/committees/download.php/25090/IssueConstraints 12008.html <http://www.oasis-open.org/committees/download.php/25090/IssueConstraint s12008.html>
I'm starting with the assumption that we would want the default or normal behavior to be weak constraints - so I'm proposing a notation to declare when a constraint should be respected/required for interoperability, and letting the default be to assume that the constraint is not required.
------------------
Proposed notation: optionally precede the normal constraint declaration with an "s" for strong.
Example: s(topic hi-d basicHighlight-c)
This notation is parallel to the notation for attribute domains, where a leading "a" is used to identify the value as having special meaning.
Normally-declared constraints are to be ignored by conref processing, in order to ease sharing between groups that have implemented constraints primarily to enforce authoring guidelines, rather than for strict processing requirements.
If there is a processor or other strong dependency on a constraint being present, then the constraint can be declared in the document type with the prefix "s". The constraint should then be handled in exactly the way currently described in the existing design.
--------------------
Let me know if this is enough - it's a fairly simple proposal, relative to the existing one :-) But if it would be useful for me to go in and edit the original, I can.
Michael Priestley, Senior Technical Staff Member (STSM) Lead IBM DITA Architect mpri...@ca.ibm.com http://dita.xml.org/blog/25 <http://dita.xml.org/blog/25>





