An Arbortext migration can start with an editor replacement request even when the hardest work sits in publishing. Publications managers need a usable editing environment and accepted deliverables. Engineering and PLM leads need a clear path from source change to publication. We scope authoring and composition separately so an accepted editing demonstration does not conceal unfinished output work.
Inventory the behavior behind each asset
Start with a source package and the publication it produced. A directory listing is not enough: it shows what exists but not which behavior the team depends on. Pair each asset with its purpose and an owner who can explain whether that behavior still matters.
- Collect representative content with its schemas or DTDs, catalogs and entities.
- Collect graphics and fonts with the permissions needed for evaluation.
- Include editing frameworks and scripts, noting local rules or identifier handling.
- Include transforms and publishing assets with a reference PDF and its build configuration.
Choose content that exposes difficult behavior rather than only clean pages. Useful cases include long tables with repeated headers, references across modules and unusual page sequences. Add multilingual material where it belongs in the delivery scope. Record missing dependencies before estimating reuse.
Assess output behavior independently of the editor
Map each agreed output behavior to the proposed transform and formatting engine. Classify it as reusable, adaptable or needing implementation. Include font handling and extensions in that assessment; do not estimate the work from stylesheet filenames alone.
PTC states that XSL-FO export needs a .style stylesheet configured for that engine. It also warns that exported XSL may not work in other XSL-FO applications and does not support that use. An export is therefore not proof that the existing publication will render unchanged in another formatter. PTC stylesheet export
Antenna House documents multilingual composition functions, including Arabic direction and mixed scripts. Use those documented capabilities to choose relevant test cases, then render the actual source with the intended fonts and settings. A capability description does not settle whether a particular page meets the delivery agreement. Antenna House multilingual functions
Agree what a meaningful PDF difference looks like
Define the comparison method before implementation. We recommend separate review categories for content correctness and appearance. A changed line break may be acceptable; a missing note or incorrect reference is a different kind of finding. Let the publication approver agree those distinctions before reviewers begin.
- Check content completeness, numbering and reference targets.
- Review table continuation, graphic placement and selected page layouts.
- Record accepted differences separately from defects that block acceptance.
Retain the source revision and build configuration with each result. Record the fonts, transforms and formatter settings so a later run can be compared on known terms. Keep the findings and their disposition with the sample instead of leaving acceptance decisions in email.
The sample becomes a production decision package
For each commissioned workstream, we scope an implemented sample with its configuration and agreed acceptance cases. The handover package includes an asset assessment and a behavior mapping. It also identifies unresolved dependencies and the work proposed for production.
Before cutover, we recommend changing the sample source and running it through the commissioned workflow again. That revision test distinguishes a repeatable process from a polished static result. Reuse the accepted comparison cases after framework or stylesheet changes to look for regressions.
Use the findings to plan content preparation and implementation work. Include author training, operating instructions and parallel output review in the production scope where needed. Keep the existing route available until the agreed acceptance cases pass and the responsible owner approves the change.
Qualification rests on the scoped demonstration
Dakota is listed among Oxygen XML consulting partners under training and consulting. That listing supports our role in framework assessment; it does not establish compatibility with a specific program or prove a publishing migration. Oxygen consulting partners The implemented sample and revision evidence provide the basis for that decision.
Bring a real source package, its required output and the person who accepts delivery to the scoping workshop.
Sources
- S1000D Framework add-on — Syncro Soft / Oxygen, publication date not stated.
- Exporting Stylesheets — PTC, publication date not stated.
- Antenna House Formatter multilingual functions — Antenna House, publication date not stated.
- Oxygen XML partners — Syncro Soft / Oxygen, publication date not stated.