W3C home > Mailing lists > Public > public-dxwg-wg@w3.org > July 2019

Re: [dxwg] New UC - Specification documents with multiple roles (#978)

From: aisaac via GitHub <sysbot+gh@w3.org>
Date: Tue, 09 Jul 2019 15:36:16 +0000
To: public-dxwg-wg@w3.org
Message-ID: <issue_comment.created-509693787-1562686575-sysbot+gh@w3.org>
@rob-metalinkage I think I agree with this use case, even though I am a bit puzzled by the fact that it quickly dives into self-reflection (i.e. "This needs explicit recognition for several reasons"). Maybe this could be mitigated by providing with example of documents that accomplish several specification roles?

Other suggestions: 
- "role of documents w.r.t. specification" and "role w.r.t. specification" may be simpler if written "specification role" (of (parts of) documents)
- get rid of "the pattern" (which is not defined/introduced)
- I somehow have the feeling that you have listed the 3 requirements in the reverse order of intuitiveness and importance. Can you re-order them into ("Each document may perform multiple roles w.r.t. specifications". "The role of documents w.r.t. specifications needs to be explicit" "Documents that perform multiple roles, such as multiple discrete sets of requirements, suggestions etc need provide stable identifiers for each logical grouping of specifications."





-- 
GitHub Notification of comment by aisaac
Please view or discuss this issue at https://github.com/w3c/dxwg/issues/978#issuecomment-509693787 using your GitHub account
Received on Tuesday, 9 July 2019 15:36:18 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 30 October 2019 00:15:54 UTC