[dxwg] Proposal for the structure of the "Guidance for Application Profiles" document

larsgsvensson has just created a new issue for https://github.com/w3c/dxwg:

== Proposal for the structure of the "Guidance for Application Profiles" document ==
The document [Guidance for Application Profiles](https://w3c.github.io/dxwg/profiles/) currently has only three sections and very little text. I propose the following structure (to be extended as we go):
* Introduction (non-normative)
* Definitions
    * Profile
    * Schema
    * Formalism
    * ...
* Profile description
    * This is the meat of the document. Important parts are:
        * A profile MUST have URI (or an IRI?) identifying it. The URI SHOULD be an http URI
        * A profile SHOULD have a title
        * A profile SHOULD have a textual description intended for humans
        * A profile's description MAY be expressed using a formal model we define (such as @rob-metalinkage 's proposal)
        * A profile document SHOULD link to schemas implementing the profile it describes
* Examples (non-normative)
    * ODRL is a good example since their profiles are explicitly media-type independent
* Bibliography

Comments and counter-proposals are most welcome.


Please view or discuss this issue at https://github.com/w3c/dxwg/issues/196 using your GitHub account

Received on Thursday, 12 April 2018 15:15:23 UTC