Transition IHE DEV TF (final text) to AsciiDoc

ToddCooper commented 2 months ago

As the IHE Devices domain advances two AsciiDoc-based profiles (SDPi & PCIM), the domain is also planning on migrating the DEV Technical Framework (TF) to AsciiDoc + organize the publication such that it is more easily maintainable in future updates, including getting to quarterly or semi-annual TF updates.

 NOTE:  This issue more rightly belongs to the IHE DEV repository, but it will get better review here ... for now.

This effort encompasses a number of issues that should be addressed, including:

Centralized location of the AsciiDoc IHE Style "converter" & related tooling (Github actions) - so all IHE DEV artifacts work from the same tool set
Documentation for how to use AsciiDoc language (style conventions & tooling)
Organization of the HTML published specifications on profiles.ihe.net/DEV that supports both FT & TI specifications (e.g., similar to ITI TF volume 1
Multi-file integration, including links between files
Requirements integration across profiles, including numbering strategy
...

ToddCooper commented 2 months ago

SDPi Friday 2024.04.03 - Reviewed issue and confirmed the initial set of subtasks.

ToddCooper commented 1 month ago

SDPi Workshop 3 2024.06.05:

See notes from Wednesday.

IHE / DEV.SDPi

Transition IHE DEV TF (final text) to AsciiDoc #289