Re: [dxwg] A profile should have human-readable documentation that expresses for humans the main components of a profile, which can also be available as machine-readable resources (ontology or schema files, SHACL files, etc). This includes listing of elements in the profile, instructions and recommendations on how to use them, constraints that determine what data is valid according to the profile, etc.

In PROF terms a Profile, <http://example.org/resource/profile-x>, SHOULD have this:

```
<http://example.org/resource/profile-x> a prof:Profile ;
  prof:hasResource [  # a Resource Descriptor
    rdfs:label "Guidance document" ;
    dct:format "http://w3id.org/mediatype/application/pdf" ;
    prof:hasRole <http://www.w3.org/ns/prof/roles/Guidance> ;  # just using a possible namespace
    prof:hasArtifact <http://example.org/resource/docs/profile-x.pdf>  # the actual PDF Guidance doc
] ;
#... other Resource Descriptors for things such as SHACL files
```

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

Received on Thursday, 8 November 2018 22:30:17 UTC