Re: [dxwg] Max's profiles ont doc concerns

I have partially addressed all these concerns in Commit https://github.com/w3c/dxwg/commit/2843f9f11df2ae5f8e66444d09370967cdbba6fc. For each point:

1. It's going to take a little time to get this definitions point right as we have to redo the naming of `Resource Descriptor` (Issue https://github.com/w3c/dxwg/issues/573) so I can't address all of these now but I have de-duplicated hasRole & hasResourceRole (the latter is redundant). 

2. I have added in a definition for "aspect" straight from the dictionary: "a particular part or feature" and I think this make clear the generic usage of the term is intended.

3. All definitions use the same style ("A..." or "An...") except for one of the two coming directly, unaltered, from Dublin Core Terms: `dct:standard`.

4. There has been much discussion about the name of the class and, as indicated above, discussion for this is now in Issue https://github.com/w3c/dxwg/issues/573 which is linked to in the doc. Also, I have changed the wording as you suggest to replace "must" with "allows for" or similar.

5. Where? I only see dcterms in the citation [[DCTERMS]], I can't find any other occurrences. There were 3 occurrences in the Roles vocab, now updated.

6. I've addressed the points you raised and many other points of spelling and grammar have now been addressed by a series of edits from Antoine, Karen, Lars, Andrea, Alejandra so I think this is in a much better state now.

-- 
GitHub Notification of comment by nicholascar
Please view or discuss this issue at https://github.com/w3c/dxwg/issues/572#issuecomment-438885978 using your GitHub account

Received on Thursday, 15 November 2018 01:48:43 UTC