Skip to content
Permalink
Browse files

Merge pull request #336 from w3c/profile-guidance-doc

moved stub text to ReSpec Issues
  • Loading branch information...
rob-metalinkage committed Sep 5, 2018
2 parents 2a31255 + 1b3e178 commit 0f0fe8817212acf66f8995c12c00d91a0f4a3dc4
Showing with 66 additions and 35 deletions.
  1. +66 −35 profiles/index.html
@@ -25,13 +25,14 @@ <h1>Profiling Family of Documents</h1>
overview of all documents. It is the recommended starting point.
</p>
<ul>
<li>[[PROF-GUIDE]] (W3C Recommendation), the top-level general profiling guidance document giving an overview of all other documents</li>
<li>[[PROF-GUIDE]] (W3C Recommendation), this document. The top-level, general, document giving general guidance and an overview of all other documents</li>
<li>[[PROF-CONNEG]] (W3C Recommendation), specific guidance on how to negotiate for Internet resource content using profiles</li>
<li>[[PROF-IETF]] (<a href="http://www.ietf.org">IETF</a> <a href="http://www.ietf.org/standards/ids/">Internet-Draft</a>), HTTP Headers for HTTP content negotiation by profile</li>
<li>[other] (xxxxxxx), TBD</li>
</ul>
<div class="issue" title="Check all PROF-* docs are listed"></div>
</section>
<section id="tof"></section>
<div class="issue" title="Render a List of Table,s not Figures"></div>
<section id="introduction">
<h1>Introduction</h1>
<p>
@@ -71,24 +72,47 @@ <h1>Introduction</h1>
</p>
</section>
<section id="definitions">
<h2>Definition</h2>
<p>
A <dfn>standard</dfn> is "A basis for comparison; a reference point against which other things can be evaluated." (from [[DCTERMS]].
</p>
<p>
A <dfn>specification</dfn> is "An act of identifying something precisely or of stating a precise requirement." (<a href="https://en.oxforddictionaries.com/definition/specification">Oxford English Dictionary</a>)
</p>
<p>
A <dfn>formalism</dfn> is...
</p>
<p>TODO</p>
<p>
A <dfn>profile</dfn> is a named set of constraints on one or more identified base specifications,
including the identification of any implementing subclasses of datatypes,
semantic interpretations, vocabularies, options and parameters of those base specifications
necessary to accomplish a particular function.
</p>
<p class="note">"Profile" here includes what are often called "application profiles", "metadata application profiles", or "metadata profiles".</p>
<h2>Definitions</h2>
<figure>
<table class="defn">
<tr>
<th>Term</th><th>Definition</th><th>Reference</th>
</tr>
<tr>
<td><dfn>profile</dfn></td>
<td>
<p>
A named set of constraints on one or more identified base specifications,
including the identification of any implementing subclasses of datatypes,
semantic interpretations, vocabularies, options and parameters of those base specifications
necessary to accomplish a particular function.
</p>
<p>
This definition includes what are often called "application profiles", "metadata application
profiles", or "metadata profiles".
</p>
</td>
<td>This document</td>
</tr>
<tr>
<td><dfn>formalism</dfn></td>
<td></td>
<td></td>
</tr>
<tr>
<td><dfn>specification</dfn></td>
<td>An act of identifying something precisely or of stating a precise requirement.</td>
<td><a href="https://en.oxforddictionaries.com/definition/specification">Oxford English Dictionary</a></td>
</tr>
<tr>
<td><dfn>standard</dfn></td>
<td>A basis for comparison; a reference point against which other things can be evaluated.</td>
<td>[[DCTERMS]]</td>
</tr>
</table>
<figcaption>Table of Definitions</figcaption>
</figure>
<div class="issue" title="Complete table of definitions"></div>
</section>
<section id="motivation">
<h2>Motivation</h2>
@@ -119,21 +143,6 @@ <h3>Dublin Core Application Profile &amp; The Singapore Framework</h3>
<p>The Singapore Framework for Dublin Core Application Profiles [[DCSF]]</p>
<p>The Guidelines for Dublin Core Application Profiles [[DCAP]] </p>
<p>Description Set Profiles: A constraint language for Dublin Core Application Profiles [[DCDSP]]</p>
<section id="dcap-defn">
<h4>DC AP &amp SF Definitions</h4>
<p>The following term definitions, taken from the DC AP &amp; SF specifications ([[DCAP]], [[DCSF]] &amp; [[DCDSP]]) are included to indicate how this document's definitions contrast with those of previous work.</p>
<figure id="dc-defn">
<table class="defn">
<tr>
<th>Term</th><th>Definition</th><th>Reference</th>
</tr>
<tr>
<td><em>profile</em></td><td>The term profile is widely used to refer to a document that describes how standards or specifications are deployed to support the requirements of a particular application, function, community, or context. In the metadata community, the term _application profile_has been applied to describe the tailoring of standards for specific applications.</td><td>[[DCSF]]</td>
</tr>
</table>
<figcaption>Profile-related term definitions from the DC AP &amp; SF specifications [[DCAP]], [[DCSF]] &amp; [[DCDSP]]</figcaption>
</figure>
</section>
</section>
<section id="ogcp">
<h3>Open Geospatial Consortium Profiling</h3>
@@ -143,13 +152,34 @@ <h3>Open Geospatial Consortium Profiling</h3>
<h3>Profiling of ISO standards</h3>
<p></p>
</section>
<section id="relatedworkdefns">
<h4>Related Definitions</h4>
<p>The following term definitions, taken from the DC AP &amp; SF specifications ([[DCAP]], [[DCSF]] &amp; [[DCDSP]]) are included to indicate how this document's definitions contrast with those of previous work.</p>
<figure id="relateddefn">
<table class="defn">
<tr>
<th>Term</th><th>Definition</th><th>Reference</th>
</tr>
<tr>
<td><em>profile</em></td><td>The term profile is widely used to refer to a document that describes how standards or specifications are deployed to support the requirements of a particular application, function, community, or context. In the metadata community, the term _application profile_has been applied to describe the tailoring of standards for specific applications.</td><td>[[DCSF]]</td>
</tr>
</table>
<figcaption>Table of profile-related term definitions from the related works</figcaption>
</figure>
<div class="issue" title="Complete table of related works' definitions"></div>
</section>
</section>
<section id="guidance">
<h2>Guidance for Profiles</h2>
<p>
This section lists, and then addresses, individual requirements that the Dataset Exchange Working Group
considered important to address to define and work with profiles.
</p>
<div class="issue" title="Incorporate structure from wiki/Issues discussion">
<a href="https://www.w3.org/2017/dxwg/wiki/ProfileRoundup">Profile Roundup</a>:
<a href="https://github.com/w3c/dxwg/issues/196">Issue/196</a>,
<a href="https://github.com/w3c/dxwg/issues/242">Issue/242</a>
</div>
<section id="description">
<h3>Profile Description</h3>
<p class="note">From F2F3 outline: What does profileDesc do?</p>
@@ -261,6 +291,7 @@ <h3>Functions of Profiles</h3>
<h2>Examples</h2>
<p class="note">From F2F3 outline: examples of profiles like DCAT-AP, BIBFRAME, ADMS, others?</p>
</section>
<div class="issue" title="Determine references for a 'Normative references' subsection"></div>
<script class="remove" src="config.js"></script>
<script class="remove" src="https://www.w3.org/Tools/respec/respec-w3c-common"></script>
</body>

0 comments on commit 0f0fe88

Please sign in to comment.
You can’t perform that action at this time.