From c056c81f83b8c55e07582739591fbf533edb166f Mon Sep 17 00:00:00 2001 From: Nicholas Car Date: Fri, 8 Aug 2025 22:26:40 +1000 Subject: [PATCH 1/3] what is & scope sections --- shacl12-profiling/index.html | 48 ++++++++++++++++++++++++++++++++++-- 1 file changed, 46 insertions(+), 2 deletions(-) diff --git a/shacl12-profiling/index.html b/shacl12-profiling/index.html index 042d9d39..c97174b4 100644 --- a/shacl12-profiling/index.html +++ b/shacl12-profiling/index.html @@ -420,10 +420,10 @@

- This document defines extensions of the SHACL Shapes Constraint Language created to allow for the profiling of specifications. + This document defines extensions of the SHACL Shapes Constraint Language created to allow for profiling.

- SHACL is a language for validating RDF graphs against a set of conditions, so this document's scope is limited to the profiling of RDF graph models, including SHACL-defined models. + SHACL is a language for validating RDF graphs against a set of conditions, so this document's scope is limited to profiling of RDF graph models, including SHACL-defined models.

@@ -438,6 +438,50 @@

Introduction

+
+

What is profiling?

+

+ Profiling is the act of creating a "profile" of something. +

+

+ Generically, in English, a "profile" of something is: +

+

+ The outline of a physical object or feature, or a representation of this +

- Oxford English dictionary, use of the word "profile" since the 17th century +

+

+ Within the world of data, a derived definition of "profile" consistent with the above is: +

+

+ A summary or an extraction +

+

+ In this definition, the essence of the English word is retained since a summary or extraction of/from a data object may be an outline of it, for example a 2D representation of a 3D spatial object or a statistical summary of a dataset with lots of parts. +

+

+ SHACL, by definition, constrains (RDF) data, and thus any data valid according to a shapes graph will be a profile of the data graph that was validated. In the case of a shapes graph validating all elements of a data graph, the valid data will be a "null" profile of the data graph, that is identical to it. +

+

+ The W3C's Profiles Vocabulary [[dx-prof]] has defined "data profiling" profiling in the context of specifications or data specifications: +

+

+ A data specification that constrains, extends, combines, or provides guidance or explanation about the usage of other data specifications. +

+

+ If a shapes graph is taken to be a "data specification", and it can sensibly be, then in addition to data valid according to a shapes graph being a profile of the data graph validated, the shapes graph itself is a profile of the data model used for a data graph. +

+
+
+

Scope

+

+ With the above section's concepts in mind, this document defines: +

+
    +
  1. profiles of SHACL
    2. +
  2. how to make profiles with SHACL
    3. +
+

SHACL Profiling is the act of creating a profile of an RDF graph From adb648c749af114ec3c38437e3af9b4c1538cc3c Mon Sep 17 00:00:00 2001 From: Nicholas Car Date: Sat, 9 Aug 2025 12:41:03 +1000 Subject: [PATCH 2/3] applying Ted's grammar changes --- shacl12-profiling/index.html | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/shacl12-profiling/index.html b/shacl12-profiling/index.html index c97174b4..14145b4a 100644 --- a/shacl12-profiling/index.html +++ b/shacl12-profiling/index.html @@ -444,38 +444,38 @@

What is profiling?

Profiling is the act of creating a "profile" of something.

- Generically, in English, a "profile" of something is: + Generically, in English, a "profile" of something is as follows:

The outline of a physical object or feature, or a representation of this

- Oxford English dictionary, use of the word "profile" since the 17th century

- Within the world of data, a derived definition of "profile" consistent with the above is: + Within the world of data, a derived definition of "profile" consistent with the above is —

A summary or an extraction

- In this definition, the essence of the English word is retained since a summary or extraction of/from a data object may be an outline of it, for example a 2D representation of a 3D spatial object or a statistical summary of a dataset with lots of parts. + In this definition, the essence of the English word is retained, since a summary or extraction of or from a data object may be an outline of it; for example, a 2D representation of a 3D spatial object. or a statistical summary of a dataset having lots of parts.

- SHACL, by definition, constrains (RDF) data, and thus any data valid according to a shapes graph will be a profile of the data graph that was validated. In the case of a shapes graph validating all elements of a data graph, the valid data will be a "null" profile of the data graph, that is identical to it. + By definition, SHACL constrains (RDF) data; thus, any data that is valid according to a shapes graph will be a profile of the data graph that was validated. In the case of a shapes graph validating all elements of a data graph, the valid data will be a "null" profile of the data graph, that is identical to it.

- The W3C's Profiles Vocabulary [[dx-prof]] has defined "data profiling" profiling in the context of specifications or data specifications: + The W3C's Profiles Vocabulary [[dx-prof]] has defined "data profiling" in the context of specifications or data specifications:

- A data specification that constrains, extends, combines, or provides guidance or explanation about the usage of other data specifications. + A data specification that constrains, extends, combines, or provides guidance or explanation about the use of other data specifications.

- If a shapes graph is taken to be a "data specification", and it can sensibly be, then in addition to data valid according to a shapes graph being a profile of the data graph validated, the shapes graph itself is a profile of the data model used for a data graph. + If a shapes graph is taken to be a "data specification" (and it can sensibly be), then, in addition to data valid according to a shapes graph being a profile of the data graph validated, the shapes graph itself is a profile of the data model used for the data graph.

Scope

- With the above section's concepts in mind, this document defines: + With the above section's concepts in mind, this document defines the following:

  1. profiles of SHACL
    2. From c9a37c69497a1f9840c3c6bfbc966ddcc323211d Mon Sep 17 00:00:00 2001 From: Nicholas Car Date: Sat, 9 Aug 2025 13:15:34 +1000 Subject: [PATCH 3/3] SHACL Specifications section; use of "specification", not "document", throughout --- shacl12-profiling/index.html | 106 +++++++++++++++++++++++------------ 1 file changed, 69 insertions(+), 37 deletions(-) diff --git a/shacl12-profiling/index.html b/shacl12-profiling/index.html index 14145b4a..9084190b 100644 --- a/shacl12-profiling/index.html +++ b/shacl12-profiling/index.html @@ -7,7 +7,7 @@