Author: anuzzolese
Date: Tue Jan 10 17:49:05 2012
New Revision: 1229658
URL: http://svn.apache.org/viewvc?rev=1229658&view=rev
Log:
[STANBOL-453] Committed patch posted by Alberto Musetti about the documentation
of the Refactor.
Added:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/refactor.mdtext
Added:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/refactor.mdtext
URL:
http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/refactor.mdtext?rev=1229658&view=auto
==============================================================================
---
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/refactor.mdtext
(added)
+++
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/refactor.mdtext
Tue Jan 10 17:49:05 2012
@@ -0,0 +1,22 @@
+Title: Refactor
+
+The Refactor is a service which allows to interpret rules in order to perform
refactoring of RDF graphs. For the refactoring the set of rules in the recipes
are interpreted and run as SPARQL CONTRUCT in which the where clause is derived
from the body of the rule and the construct clause is derived from the head of
the rule. The output of a refactoring is a transformed graph which satisfies
the constraints expressed in the rules. The refactoring in useful for tasks of
semantic harmonization of RDF graphs expressed with different
ontologies/vocabularies towards their representation with a single ontology or
vocagulary. The output of a refactoring is a transformed graph which satisfies
the constraints expressed in the rules.
+
+## Terminology
+
+* A __Recipe__ is a set of rules defined according to a specific task. Rules
are written in a specific syntax, and can then be executed for refactoring (as
SPARQL queries) or through reasoning services.
+* __Refactoring__ is the task aimed to perform the transformation of RDF
graphs. The transformation is driven by refactoring rules, basically Stanbol
Rules interpreted as SPARQL CONSTRUCT clauses.
+* __Reasoning__ is the activity of interpreting axioms for inferring new
knowledge, classifying, checking the consistency of an ontology, etc...
+
+## Usage Scenarios
+
+Supposing we have configured the IKS (i.e. Stanbol EntityHub) in order to
fetch entities about persons from DBpedia. Now we want to represent these
entities adopting the vocabulary from schema.org and produce schemaOrg Rich
Snippets in order to provide to the IKS search engine optimization
capabilities. What we need to do is to write a recipe and calling the Refactor
via HTTP REST passing to it the recipe itself and the entities we have fetched
from Linked Data.
+
+## Usage
+
+
+### Service Endpoints
+
+
+____
+_[Back to Stanbol Rules](../rules.html)_
\ No newline at end of file
