diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc index 49e74d2..641f2d2 100644 --- a/docs/modules/ROOT/nav.adoc +++ b/docs/modules/ROOT/nav.adoc @@ -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] diff --git a/docs/modules/ROOT/pages/handbook-as-a-whole.adoc b/docs/modules/ROOT/pages/handbook-as-a-whole.adoc new file mode 100644 index 0000000..7ac1c96 --- /dev/null +++ b/docs/modules/ROOT/pages/handbook-as-a-whole.adoc @@ -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[] \ No newline at end of file diff --git a/docs/modules/ROOT/pages/how-to-map-existing-data-models.adoc b/docs/modules/ROOT/pages/how-to-map-existing-data-models.adoc index 0fc5663..fab42ec 100644 --- a/docs/modules/ROOT/pages/how-to-map-existing-data-models.adoc +++ b/docs/modules/ROOT/pages/how-to-map-existing-data-models.adoc @@ -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