W3C home > Mailing lists > Public > public-dxwg-wg@w3.org > April 2018

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

From: Lars G. Svensson via GitHub <sysbot+gh@w3.org>
Date: Thu, 12 Apr 2018 15:15:21 +0000
To: public-dxwg-wg@w3.org
Message-ID: <issues.opened-313772036-1523546120-sysbot+gh@w3.org>
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

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:42:01 UTC