Changes between Version 10 and Version 11 of Public/StartPageTransPubSoftware

Timestamp:

Sep 22, 2022, 5:40:27 PM (20 months ago)

Author:

Boris Horner

Comment:

—

Public/StartPageTransPubSoftware

@@ -61 +61 @@
 
 == Migration framework for semi-automatic source to target conversion
-When introducing a system like a [wiki:Public/StartPageCinnamon CCMS] or moving from one to another, it is often necessary to convert the data into the target system's structure. This involves converting the source to the target format, applying heuristics, for example, for mapping Microsoft Word paragraph formats to DITA elements. Migration also involves modularization and re-use.
+When introducing a system like a [wiki:Public/StartPageCinnamon CCMS] or moving from one to another, it is often necessary to convert the data into the target system's structure. This involves converting the source to the target format, applying heuristics, for example, for mapping Microsoft Word paragraph formats to DITA elements. Migration also involves modularization, application of semantics and re-use.
 
+The entire migration is a process that integrates manual and automatic steps, not in the way that automation creates output and then the authors work them over, but rather as a sequence of manual and automatic steps, for example:
+* Automatic: conversion of Microsoft Word documents to DITA, breaking up to modules by rules.
+* Manual: merging, splitting and editing the modules.
+* Manual: application of semantics, like deciding, a module will be a DITA task.
+* Automatic: Recreating the module from the source based on the semantic logic.
+* Manual: re-using modules instead of creating duplicates.
+* Automatic: extracting metadata from the content.
+* Manual: editing or completing the metadata.
+* Automatic: import into the CCMS.
 
-
+The integration of manual and automatic steps is handled by our **Conversion Framework Tool**. Structural conversions can be coded in XQuery, allowing easy access and complex logics and heuristics. Programming interfaces allow to attach custom code. To efficiently use the tool, some XQuery and other coding is required, but considering the amount of data typically affected, it helps saving a large amount of manual copy / paste work and avoiding errors.