SMART Base
0.2.0 - ci-build

SMART Base, published by WHO. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-base/tree/main and changes regularly. See the Directory of published versions
Built from commit d97caff5.

: Can manage releases - JSON Representation

Draft as of 2026-03-20

Raw json | Download

{
  "resourceType" : "Requirements",
  "id" : "SGAuthoring.Skills.ManageReleases",
  "meta" : {
    "profile" : [
      🔗 "http://smart.who.int/base/StructureDefinition/SGRequirements"
    ]
  },
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><div xml:lang=\"en\" lang=\"en\"><hr/><p><b>English</b></p><hr/><p class=\"res-header-id\"><b>Generated Narrative: Requirements SGAuthoring.Skills.ManageReleases</b></p><a name=\"SGAuthoring.Skills.ManageReleases\"> </a><a name=\"hcSGAuthoring.Skills.ManageReleases\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>These requirements apply to the actor <a href=\"ActorDefinition-SGAuthoring.Persona.PublicationManager.html\">Publication Manager</a></p><table class=\"grid\"><tr><td><b><a name=\"REL-01\"> </a></b>Determine version number</td><td>SHALL</td><td><div><p>Can review changes since last release, determine if changes are breaking, and update version number following semantic versioning.</p>\n</div></td></tr><tr><td><b><a name=\"REL-02\"> </a></b>Update IG status for release</td><td>SHALL</td><td><div><p>Can update IG and all conformance artifacts: status to active, version without label, releaseLabel to release, and date to current date.</p>\n</div></td></tr><tr><td><b><a name=\"REL-03\"> </a></b>Create publication-request.json</td><td>SHALL</td><td><div><p>Can create a correct publication-request.json with matching package-id, version, path, ci-build, and first/subsequent flags.</p>\n</div></td></tr><tr><td><b><a name=\"REL-04\"> </a></b>Create release tag</td><td>SHALL</td><td><div><p>Can create a GitHub release and tag in the form vX.Y.Z to trigger the automated publication workflow.</p>\n</div></td></tr><tr><td><b><a name=\"REL-05\"> </a></b>Verify publication</td><td>SHALL</td><td><div><p>Can verify the publication workflow succeeded and the IG is available at the sitepreview URL.</p>\n</div></td></tr><tr><td><b><a name=\"REL-06\"> </a></b>Reset to draft</td><td>SHALL</td><td><div><p>Can reset the main branch to draft status with updated version number after publication.</p>\n</div></td></tr><tr><td><b><a name=\"REL-07\"> </a></b>Maintain change log</td><td>SHALL</td><td><div><p>Can maintain a changes page with release summary, known issues, and categorized changes (non-compatible, compatible substantive, non-substantive).</p>\n</div></td></tr></table></div><div xml:lang=\"fr\" lang=\"fr\"><hr/><p><b>French</b></p><hr/><p class=\"res-header-id\"><b>Narratif généré : Requirements SGAuthoring.Skills.ManageReleases</b></p><a name=\"fr-SGAuthoring.Skills.ManageReleases\"> </a><a name=\"fr-hcSGAuthoring.Skills.ManageReleases\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profil: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>Ces exigences s'appliquent à l'acteur <a href=\"ActorDefinition-SGAuthoring.Persona.PublicationManager.html\">Publication Manager</a></p><table class=\"grid\"><tr><td><b><a name=\"fr-REL-01\"> </a></b>Determine version number</td><td>SHALL</td><td><div><p>Can review changes since last release, determine if changes are breaking, and update version number following semantic versioning.</p>\n</div></td></tr><tr><td><b><a name=\"fr-REL-02\"> </a></b>Update IG status for release</td><td>SHALL</td><td><div><p>Can update IG and all conformance artifacts: status to active, version without label, releaseLabel to release, and date to current date.</p>\n</div></td></tr><tr><td><b><a name=\"fr-REL-03\"> </a></b>Create publication-request.json</td><td>SHALL</td><td><div><p>Can create a correct publication-request.json with matching package-id, version, path, ci-build, and first/subsequent flags.</p>\n</div></td></tr><tr><td><b><a name=\"fr-REL-04\"> </a></b>Create release tag</td><td>SHALL</td><td><div><p>Can create a GitHub release and tag in the form vX.Y.Z to trigger the automated publication workflow.</p>\n</div></td></tr><tr><td><b><a name=\"fr-REL-05\"> </a></b>Verify publication</td><td>SHALL</td><td><div><p>Can verify the publication workflow succeeded and the IG is available at the sitepreview URL.</p>\n</div></td></tr><tr><td><b><a name=\"fr-REL-06\"> </a></b>Reset to draft</td><td>SHALL</td><td><div><p>Can reset the main branch to draft status with updated version number after publication.</p>\n</div></td></tr><tr><td><b><a name=\"fr-REL-07\"> </a></b>Maintain change log</td><td>SHALL</td><td><div><p>Can maintain a changes page with release summary, known issues, and categorized changes (non-compatible, compatible substantive, non-substantive).</p>\n</div></td></tr></table></div><div xml:lang=\"ar\" lang=\"ar\"><hr/><p><b>Arabic</b></p><hr/><p class=\"res-header-id\"><b>السرد المُنشأ: Requirements SGAuthoring.Skills.ManageReleases</b></p><a name=\"ar-SGAuthoring.Skills.ManageReleases\"> </a><a name=\"ar-hcSGAuthoring.Skills.ManageReleases\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">الملف الشخصي: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>تنطبق هذه المتطلبات على الممثل <a href=\"ActorDefinition-SGAuthoring.Persona.PublicationManager.html\">Publication Manager</a></p><table class=\"grid\"><tr><td><b><a name=\"ar-REL-01\"> </a></b>Determine version number</td><td>SHALL</td><td><div><p>Can review changes since last release, determine if changes are breaking, and update version number following semantic versioning.</p>\n</div></td></tr><tr><td><b><a name=\"ar-REL-02\"> </a></b>Update IG status for release</td><td>SHALL</td><td><div><p>Can update IG and all conformance artifacts: status to active, version without label, releaseLabel to release, and date to current date.</p>\n</div></td></tr><tr><td><b><a name=\"ar-REL-03\"> </a></b>Create publication-request.json</td><td>SHALL</td><td><div><p>Can create a correct publication-request.json with matching package-id, version, path, ci-build, and first/subsequent flags.</p>\n</div></td></tr><tr><td><b><a name=\"ar-REL-04\"> </a></b>Create release tag</td><td>SHALL</td><td><div><p>Can create a GitHub release and tag in the form vX.Y.Z to trigger the automated publication workflow.</p>\n</div></td></tr><tr><td><b><a name=\"ar-REL-05\"> </a></b>Verify publication</td><td>SHALL</td><td><div><p>Can verify the publication workflow succeeded and the IG is available at the sitepreview URL.</p>\n</div></td></tr><tr><td><b><a name=\"ar-REL-06\"> </a></b>Reset to draft</td><td>SHALL</td><td><div><p>Can reset the main branch to draft status with updated version number after publication.</p>\n</div></td></tr><tr><td><b><a name=\"ar-REL-07\"> </a></b>Maintain change log</td><td>SHALL</td><td><div><p>Can maintain a changes page with release summary, known issues, and categorized changes (non-compatible, compatible substantive, non-substantive).</p>\n</div></td></tr></table></div><div xml:lang=\"zh\" lang=\"zh\"><hr/><p><b>Chinese</b></p><hr/><p class=\"res-header-id\"><b>Generated Narrative: Requirements SGAuthoring.Skills.ManageReleases</b></p><a name=\"zh-SGAuthoring.Skills.ManageReleases\"> </a><a name=\"zh-hcSGAuthoring.Skills.ManageReleases\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>These requirements apply to the actor <a href=\"ActorDefinition-SGAuthoring.Persona.PublicationManager.html\">Publication Manager</a></p><table class=\"grid\"><tr><td><b><a name=\"zh-REL-01\"> </a></b>Determine version number</td><td>SHALL</td><td><div><p>Can review changes since last release, determine if changes are breaking, and update version number following semantic versioning.</p>\n</div></td></tr><tr><td><b><a name=\"zh-REL-02\"> </a></b>Update IG status for release</td><td>SHALL</td><td><div><p>Can update IG and all conformance artifacts: status to active, version without label, releaseLabel to release, and date to current date.</p>\n</div></td></tr><tr><td><b><a name=\"zh-REL-03\"> </a></b>Create publication-request.json</td><td>SHALL</td><td><div><p>Can create a correct publication-request.json with matching package-id, version, path, ci-build, and first/subsequent flags.</p>\n</div></td></tr><tr><td><b><a name=\"zh-REL-04\"> </a></b>Create release tag</td><td>SHALL</td><td><div><p>Can create a GitHub release and tag in the form vX.Y.Z to trigger the automated publication workflow.</p>\n</div></td></tr><tr><td><b><a name=\"zh-REL-05\"> </a></b>Verify publication</td><td>SHALL</td><td><div><p>Can verify the publication workflow succeeded and the IG is available at the sitepreview URL.</p>\n</div></td></tr><tr><td><b><a name=\"zh-REL-06\"> </a></b>Reset to draft</td><td>SHALL</td><td><div><p>Can reset the main branch to draft status with updated version number after publication.</p>\n</div></td></tr><tr><td><b><a name=\"zh-REL-07\"> </a></b>Maintain change log</td><td>SHALL</td><td><div><p>Can maintain a changes page with release summary, known issues, and categorized changes (non-compatible, compatible substantive, non-substantive).</p>\n</div></td></tr></table></div><div xml:lang=\"ru\" lang=\"ru\"><hr/><p><b>Russian</b></p><hr/><p class=\"res-header-id\"><b>Сгенерированный нарратив: Requirements SGAuthoring.Skills.ManageReleases</b></p><a name=\"ru-SGAuthoring.Skills.ManageReleases\"> </a><a name=\"ru-hcSGAuthoring.Skills.ManageReleases\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Профиль: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>Эти требования распространяются и на актера <a href=\"ActorDefinition-SGAuthoring.Persona.PublicationManager.html\">Publication Manager</a></p><table class=\"grid\"><tr><td><b><a name=\"ru-REL-01\"> </a></b>Determine version number</td><td>SHALL</td><td><div><p>Can review changes since last release, determine if changes are breaking, and update version number following semantic versioning.</p>\n</div></td></tr><tr><td><b><a name=\"ru-REL-02\"> </a></b>Update IG status for release</td><td>SHALL</td><td><div><p>Can update IG and all conformance artifacts: status to active, version without label, releaseLabel to release, and date to current date.</p>\n</div></td></tr><tr><td><b><a name=\"ru-REL-03\"> </a></b>Create publication-request.json</td><td>SHALL</td><td><div><p>Can create a correct publication-request.json with matching package-id, version, path, ci-build, and first/subsequent flags.</p>\n</div></td></tr><tr><td><b><a name=\"ru-REL-04\"> </a></b>Create release tag</td><td>SHALL</td><td><div><p>Can create a GitHub release and tag in the form vX.Y.Z to trigger the automated publication workflow.</p>\n</div></td></tr><tr><td><b><a name=\"ru-REL-05\"> </a></b>Verify publication</td><td>SHALL</td><td><div><p>Can verify the publication workflow succeeded and the IG is available at the sitepreview URL.</p>\n</div></td></tr><tr><td><b><a name=\"ru-REL-06\"> </a></b>Reset to draft</td><td>SHALL</td><td><div><p>Can reset the main branch to draft status with updated version number after publication.</p>\n</div></td></tr><tr><td><b><a name=\"ru-REL-07\"> </a></b>Maintain change log</td><td>SHALL</td><td><div><p>Can maintain a changes page with release summary, known issues, and categorized changes (non-compatible, compatible substantive, non-substantive).</p>\n</div></td></tr></table></div><div xml:lang=\"es\" lang=\"es\"><hr/><p><b>Spanish</b></p><hr/><p class=\"res-header-id\"><b>Generated Narrative: Requirements SGAuthoring.Skills.ManageReleases</b></p><a name=\"es-SGAuthoring.Skills.ManageReleases\"> </a><a name=\"es-hcSGAuthoring.Skills.ManageReleases\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-SGRequirements.html\">SMART Guidelines Requirements</a></p></div><p>These requirements apply to the actor <a href=\"ActorDefinition-SGAuthoring.Persona.PublicationManager.html\">Publication Manager</a></p><table class=\"grid\"><tr><td><b><a name=\"es-REL-01\"> </a></b>Determine version number</td><td>SHALL</td><td><div><p>Can review changes since last release, determine if changes are breaking, and update version number following semantic versioning.</p>\n</div></td></tr><tr><td><b><a name=\"es-REL-02\"> </a></b>Update IG status for release</td><td>SHALL</td><td><div><p>Can update IG and all conformance artifacts: status to active, version without label, releaseLabel to release, and date to current date.</p>\n</div></td></tr><tr><td><b><a name=\"es-REL-03\"> </a></b>Create publication-request.json</td><td>SHALL</td><td><div><p>Can create a correct publication-request.json with matching package-id, version, path, ci-build, and first/subsequent flags.</p>\n</div></td></tr><tr><td><b><a name=\"es-REL-04\"> </a></b>Create release tag</td><td>SHALL</td><td><div><p>Can create a GitHub release and tag in the form vX.Y.Z to trigger the automated publication workflow.</p>\n</div></td></tr><tr><td><b><a name=\"es-REL-05\"> </a></b>Verify publication</td><td>SHALL</td><td><div><p>Can verify the publication workflow succeeded and the IG is available at the sitepreview URL.</p>\n</div></td></tr><tr><td><b><a name=\"es-REL-06\"> </a></b>Reset to draft</td><td>SHALL</td><td><div><p>Can reset the main branch to draft status with updated version number after publication.</p>\n</div></td></tr><tr><td><b><a name=\"es-REL-07\"> </a></b>Maintain change log</td><td>SHALL</td><td><div><p>Can maintain a changes page with release summary, known issues, and categorized changes (non-compatible, compatible substantive, non-substantive).</p>\n</div></td></tr></table></div></div>"
  },
  "extension" : [
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "userTask",
        "display" : "User Task"
      }
    },
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "userTask",
        "display" : "User Task"
      }
    },
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "userTask",
        "display" : "User Task"
      }
    },
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "userTask",
        "display" : "User Task"
      }
    },
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "userTask",
        "display" : "User Task"
      }
    },
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "userTask",
        "display" : "User Task"
      }
    },
    {
      "url" : "http://smart.who.int/base/StructureDefinition/SGTask",
      "valueCoding" : {
        "system" : "http://smart.who.int/base/CodeSystem/SGTasks",
        "code" : "userTask",
        "display" : "User Task"
      }
    },
    {
      "extension" : [
        {
          "url" : "http://smart.who.int/base/StructureDefinition/SGString",
          "valueString" : "manage versioning, release tags, and the publication workflow"
        },
        {
          "url" : "http://smart.who.int/base/StructureDefinition/SGString",
          "valueString" : "IG releases follow semantic versioning and are published through a governed, repeatable process"
        }
      ],
      "url" : "http://smart.who.int/base/StructureDefinition/SGUserStory"
    }
  ],
  "url" : "http://smart.who.int/base/Requirements/SGAuthoring.Skills.ManageReleases",
  "version" : "0.2.0",
  "name" : "SkillManageReleases",
  "title" : "Can manage releases",
  "status" : "draft",
  "experimental" : true,
  "date" : "2026-03-20T00:42:00+00:00",
  "publisher" : "WHO",
  "contact" : [
    {
      "name" : "WHO",
      "telecom" : [
        {
          "system" : "url",
          "value" : "http://who.int"
        }
      ]
    }
  ],
  "description" : "Capability to manage versioning, publication-request.json, release tags, and publication workflow.",
  "actor" : [
    🔗 "http://smart.who.int/base/ActorDefinition/SGAuthoring.Persona.PublicationManager"
  ],
  "statement" : [
    {
      "key" : "REL-01",
      "label" : "Determine version number",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can review changes since last release, determine if changes are breaking, and update version number following semantic versioning."
    },
    {
      "key" : "REL-02",
      "label" : "Update IG status for release",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can update IG and all conformance artifacts: status to active, version without label, releaseLabel to release, and date to current date."
    },
    {
      "key" : "REL-03",
      "label" : "Create publication-request.json",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can create a correct publication-request.json with matching package-id, version, path, ci-build, and first/subsequent flags."
    },
    {
      "key" : "REL-04",
      "label" : "Create release tag",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can create a GitHub release and tag in the form vX.Y.Z to trigger the automated publication workflow."
    },
    {
      "key" : "REL-05",
      "label" : "Verify publication",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can verify the publication workflow succeeded and the IG is available at the sitepreview URL."
    },
    {
      "key" : "REL-06",
      "label" : "Reset to draft",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can reset the main branch to draft status with updated version number after publication."
    },
    {
      "key" : "REL-07",
      "label" : "Maintain change log",
      "conformance" : [
        "SHALL"
      ],
      "requirement" : "Can maintain a changes page with release summary, known issues, and categorized changes (non-compatible, compatible substantive, non-substantive)."
    }
  ]
}