Stream: IG creation
Topic: Clarification on ImplementationGuide role
Elliot Silver (Nov 25 2021 at 18:40):
I'm trying to understand the role of the IG resource. Until recently, I thought it was necessary for building the package, but I see packages generated without an IG resource. I also see IG resources that only list the markdown or html content of the implementation guide, but omit listing the resources. I can use profiles on my server without an IG listing them, and have a valid IG that doesn't list profiles. I feel dumb asking for clarification, having been authoring them, but some recent counter examples have forced me to question the role.
Grahame Grieve (Nov 25 2021 at 18:44):
it's legal to produce packages without a IG resource, but the IG publisher doesn't know how to do that (there are other tools that do that)
The IG resource serves as both input to a tool that produces IGs (the IG publisher mostly) - tells it what to do , and an output from it, tells tools about the package that's produced. In particular, it's how tools can turn a logical reference to a resource in the IG into a literal reference to the resource in the IG
And there's conformance information in the resource as well
Elliot Silver (Nov 25 2021 at 18:51):
Grahame Grieve said:
In particular, it's how tools can turn a logical reference to a resource in the IG into a literal reference to the resource in the IG
Do you mean within an IG or package, or across IGs or packages?
And there's conformance information in the resource as well
Other than default profiles?
If I have an implementation guide (set of resources and webpages) and the ability to create a package from them, and no default profiles, is there a reason I need to create an IG resource?
Grahame Grieve (Nov 25 2021 at 18:56):
you mean in general, or with the IG publisher?
Grahame Grieve (Nov 25 2021 at 18:58):
in general, if you do that, the tools won't know how to transition from a logical reference to the resource in the package to a human navigable URL. I've put special arrangements in place for some external packages, but I'm not going to scale the special arrangements, which have a habit of breaking
Elliot Silver (Nov 25 2021 at 18:58):
I mean in general.
Last updated: Apr 12 2022 at 19:14 UTC
