You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jena.apache.org by GitBox <gi...@apache.org> on 2021/04/19 21:12:04 UTC

[GitHub] [jena-site] kinow commented on a change in pull request #48: JENA-2089: Documentation for Data+RDFS

kinow commented on a change in pull request #48:
URL: https://github.com/apache/jena-site/pull/48#discussion_r616178793



##########
File path: source/documentation/rdfs/__index.md
##########
@@ -0,0 +1,187 @@
+---
+title: Data with RDFS Inferencing
+slug: index
+---
+
+This page describes support for accessing data with additional statements
+derived using RDFS. It supports `rdfs:subClassOf`, `rdfs:subPropertyOf`, `rdfs:domain` and `rdfs:range`. It
+does not provide RDF axioms. The RDFS vocabulary is not included in the data.
+
+It does support use with RDF datasets, where each graph in the dataset has the
+same RDFS vocabulary applied to it.
+
+This is not a replacement for the [Jena RDFS Reasoner support](/inference/)
+which covers full RDFS inference.
+
+The data is updateable, and graps can be added and removed from the dataset.
+The vocabulary can not be changed during th elifetime of the RDFS dataset.

Review comment:
       s/th elifetime/the lifetime

##########
File path: source/documentation/rdfs/__index.md
##########
@@ -0,0 +1,187 @@
+---
+title: Data with RDFS Inferencing
+slug: index
+---
+
+This page describes support for accessing data with additional statements
+derived using RDFS. It supports `rdfs:subClassOf`, `rdfs:subPropertyOf`, `rdfs:domain` and `rdfs:range`. It
+does not provide RDF axioms. The RDFS vocabulary is not included in the data.
+
+It does support use with RDF datasets, where each graph in the dataset has the
+same RDFS vocabulary applied to it.
+
+This is not a replacement for the [Jena RDFS Reasoner support](/inference/)
+which covers full RDFS inference.
+
+The data is updateable, and graps can be added and removed from the dataset.

Review comment:
       s/graps/graphs

##########
File path: source/documentation/rdfs/__index.md
##########
@@ -0,0 +1,187 @@
+---
+title: Data with RDFS Inferencing
+slug: index
+---
+
+This page describes support for accessing data with additional statements
+derived using RDFS. It supports `rdfs:subClassOf`, `rdfs:subPropertyOf`, `rdfs:domain` and `rdfs:range`. It
+does not provide RDF axioms. The RDFS vocabulary is not included in the data.
+
+It does support use with RDF datasets, where each graph in the dataset has the
+same RDFS vocabulary applied to it.
+
+This is not a replacement for the [Jena RDFS Reasoner support](/inference/)
+which covers full RDFS inference.
+
+The data is updateable, and graps can be added and removed from the dataset.
+The vocabulary can not be changed during th elifetime of the RDFS dataset.
+
+### API: `RDFSFactory`
+
+The API provides operation to build RDF-enabled datasets from data storage and vocabularies:
+    
+Example:
+```
+    DatasetGraph data = ...
+    // Load the vocabulary
+    Graph vocab = RDFDataMgr.loadGraph("vocabulary.ttl");
+    // Create a DatsetGraph with RDFS
+    DatasetGraph dsg = datasetRDFS(DatasetGraph data, Graph vocab );
+    // (Optional) Present as a Dataset.
+    Dataset dataset = DatasetFactory.wrap(dsg);
+```
+
+The vocabulary is processed to produce datastructure needed for processing he

Review comment:
       s/he/the

##########
File path: source/documentation/rdfs/__index.md
##########
@@ -0,0 +1,187 @@
+---
+title: Data with RDFS Inferencing
+slug: index
+---
+
+This page describes support for accessing data with additional statements
+derived using RDFS. It supports `rdfs:subClassOf`, `rdfs:subPropertyOf`, `rdfs:domain` and `rdfs:range`. It
+does not provide RDF axioms. The RDFS vocabulary is not included in the data.
+
+It does support use with RDF datasets, where each graph in the dataset has the
+same RDFS vocabulary applied to it.
+
+This is not a replacement for the [Jena RDFS Reasoner support](/inference/)
+which covers full RDFS inference.
+
+The data is updateable, and graps can be added and removed from the dataset.
+The vocabulary can not be changed during th elifetime of the RDFS dataset.
+
+### API: `RDFSFactory`
+
+The API provides operation to build RDF-enabled datasets from data storage and vocabularies:
+    
+Example:
+```
+    DatasetGraph data = ...
+    // Load the vocabulary
+    Graph vocab = RDFDataMgr.loadGraph("vocabulary.ttl");
+    // Create a DatsetGraph with RDFS
+    DatasetGraph dsg = datasetRDFS(DatasetGraph data, Graph vocab );
+    // (Optional) Present as a Dataset.
+    Dataset dataset = DatasetFactory.wrap(dsg);
+```
+
+The vocabulary is processed to produce datastructure needed for processing he
+data eficiently at run time. This is the `SetupRDFS` class that can be created
+and shared; it is thread-safe.
+
+```
+    SetupRDFS setup = setupRDFS(vocab);
+```
+
+### Assembler: RDFS Dataset
+
+Datasets with RDFS can built with an assembler:

Review comment:
       be built?

##########
File path: source/documentation/rdfs/__index.md
##########
@@ -0,0 +1,187 @@
+---
+title: Data with RDFS Inferencing
+slug: index
+---
+
+This page describes support for accessing data with additional statements
+derived using RDFS. It supports `rdfs:subClassOf`, `rdfs:subPropertyOf`, `rdfs:domain` and `rdfs:range`. It
+does not provide RDF axioms. The RDFS vocabulary is not included in the data.
+
+It does support use with RDF datasets, where each graph in the dataset has the
+same RDFS vocabulary applied to it.
+
+This is not a replacement for the [Jena RDFS Reasoner support](/inference/)
+which covers full RDFS inference.
+
+The data is updateable, and graps can be added and removed from the dataset.
+The vocabulary can not be changed during th elifetime of the RDFS dataset.
+
+### API: `RDFSFactory`
+
+The API provides operation to build RDF-enabled datasets from data storage and vocabularies:
+    
+Example:
+```
+    DatasetGraph data = ...
+    // Load the vocabulary
+    Graph vocab = RDFDataMgr.loadGraph("vocabulary.ttl");
+    // Create a DatsetGraph with RDFS

Review comment:
       s/DatsetGraph /DatasetGraph




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org