Process
https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose
JSON-LD · diagram · in graph fhir-harness.jsonld ·
| name | Each IG, composed into a host docs site and rendered with just-the-docs |
|---|---|
| summary | How a host docs site builds every IG it mounts INSIDE itself, so each IG's pages wear the host's chrome (one sidebar, one search, one language selector) rather than being a site of their own. |
| description | How a host docs site builds every IG it mounts INSIDE itself, so each IG's pages wear the host's chrome (one sidebar, one search, one language selector) rather than being a site of their own. Subprocess of Tool stage-ig-sites; reached from docs-site-publish's Call_InstanceSites (skill docs-generation).
NO IG PUBLISHER RUNS. build-ig-site turns the IG's source into Jekyll source, with the Publisher's site.data.fhir filled from the IG's AST and sushi-config.yaml, and the host's ONE Jekyll build renders it with just-the-docs (skill ig-render-jekyll). Which IGs is DATA: each instance whose fhir-artifact-index/menu.json records a source.of (the IG repository) and source.ref (the commit). No workflow and no step here names an IG.
feature-staging.yml runs the same steps for a pull request's preview, with --changed-files, so only the IGs a change reaches are rebuilt. An IG repository building its OWN site runs stage-ig-sites --only <instance> --source <checkout> --compose-into <shell> --compose-at-root, which is ig-ast-cache's Task_BuildSite, not this process. |
| enforcement | advisory |
| sourcePath | processes/tools/ig-docs-site-compose.bpmn |
| sourceUrl | https://github.com/litlfred/fhir-harness/blob/main/processes/tools/ig-docs-site-compose.bpmn |
| depiction | https://litlfred.github.io/folio-assistant/assets/img/workflows/ig-docs-site-compose.svg |
| startNode | Host docs source composed; IG sites wanted https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/Start_Compose |
| nodeCount | 6 |
| flowCount | 5 |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | Each IG, composed into a host docs site and rendered with just-the-docs https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose |
|---|---|
| from | Host docs source composed; IG sites wanted https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/Start_Compose |
| to | Build each IG's artefact index https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/Task_Indexes |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | Each IG, composed into a host docs site and rendered with just-the-docs https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose |
|---|---|
| from | Build each IG's artefact index https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/Task_Indexes |
| to | Generate each IG instance's artefact pages https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/Task_Pages |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | Each IG, composed into a host docs site and rendered with just-the-docs https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose |
|---|---|
| from | Generate each IG instance's artefact pages https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/Task_Pages |
| to | Clone each IG at its recorded commit and stage it https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/Task_Stage |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | Each IG, composed into a host docs site and rendered with just-the-docs https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose |
|---|---|
| from | Clone each IG at its recorded commit and stage it https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/Task_Stage |
| to | Compose each staged IG into the host source https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/Task_ComposeInto |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |
| partOf | Each IG, composed into a host docs site and rendered with just-the-docs https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose |
|---|---|
| from | Compose each staged IG into the host source https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/Task_ComposeInto |
| to | Each IG composed; build list handed to the host https://litlfred.github.io/folio-assistant/fhir-harness/process/Process_IgDocsSiteCompose/node/End_Composed |
| inSubgraph | fhir-harness-processes https://litlfred.github.io/folio-assistant/fhir-harness/directory/fhir-harness-processes |