Skip to content

Commit

Permalink
added handbook-as-a-whole.adoc
Browse files Browse the repository at this point in the history
  • Loading branch information
andreea-pasare committed Jun 12, 2024
1 parent ee6dc3e commit 70f07fd
Show file tree
Hide file tree
Showing 3 changed files with 24 additions and 2 deletions.
6 changes: 5 additions & 1 deletion docs/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
@@ -1,8 +1,12 @@
* xref:introduction.adoc[Introduction]
* xref:semic-core-vocabularies.adoc[SEMIC Core Vocabularies]
* xref:conceptual-framework.adoc[Conceptual framework]
* xref:use-cases.adoc[Use cases]
* xref:how-to-create-new-data-models.adoc[How to create new data models]
* xref:how-to-map-existing-data-models.adoc[How to map existing data models]
* xref:glossary.adoc[Glossary]
* Back matter
** xref:references.adoc[References]
** xref:[Handbook as a whole]
** xref:handbook-as-a-whole.adoc[Handbook as a whole]
18 changes: 18 additions & 0 deletions docs/modules/ROOT/pages/handbook-as-a-whole.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
= The SEMIC Style Guide for Semantic Engineers
:doctype: book
ifndef::ebook-format[:leveloffset: 1]
:description: SEMIC Core Vocabularies Handbook
:sectanchors:
:url-repo: https://github.com/SEMICeu/core-vocs-handbook
:toc:
:toclevels: 2
:sectnums: 4
:icons: font

include::introduction.adoc[]
include::semic-core-vocabularies.adoc[]
include::conceptual-framework.adoc[]
include::use-cases.adoc[]
include::how-to-create-new-data-models.adoc[]
include::how-to-map-existing-data-models.adoc[]
include::glossary.adoc[]
Original file line number Diff line number Diff line change
Expand Up @@ -261,7 +261,7 @@ A comprehensive mapping package typically includes:
* *Descriptive Metadata:* Contains essential data about the mapping package, such as identification, title, description, and versions of the mapping, ontology, and source schemas. This metadata aids in the management and application of the package.
This package is designed to be self-contained, ensuring that it can be immediately integrated and operational within various data transformation pipelines. The included components support not only the application, but also the governance of the mappings, ensuring they are maintained and utilised correctly in diverse IT environments. This systematic packaging addresses critical needs for usability, maintainability, and standardisation, which are essential for widespread adoption and operational success in data transformation initiatives.

*Inputs:* Conceptual Mapping spreadsheet, Ontologies, SHACL Data Shapes, Sample XML data*, *Sample data transformed into RDF, Conceptual Mapping, SHACL data shapes, Validation reports
*Inputs:* Conceptual Mapping spreadsheet, Ontologies, SHACL Data Shapes, Sample XML data, Sample data transformed into RDF, Conceptual Mapping, SHACL data shapes, Validation reports

*Outputs:* Comprehensive Mapping Package

0 comments on commit 70f07fd

Please sign in to comment.