Categories: Issues, Problems and Projects

Categories: Issues, Problems and Projects



The table below provides general guidance on whether a work item should be categorized as an Issue, Problem or Project. Each work item should be considered in relation to the relevant dimensions and the highest category applicable chosen. If you are unsure which JIRA to add the work item to, please contact @Cathy Richardson for guidance. 



Dimensions

Issue

Problem

Project

Explanatory Comments:

Dimensions

Issue

Problem

Project

Explanatory Comments:

Editorial guidance

Editorial guidance already exists.

A change to Editorial guidance may be or is required as part of the work being done.

  • Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.

  • Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.

A change to Editorial guidance is required as part of the work being done.

  • Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.




Concept model

No changes to the concept model are required.

A review of or change to the current concept model is required with the scope of work limited to a single attribute or range.

For example:

  • A review of a current attribute

    • Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.

  • A new attribute

    • Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.

  • A review or change to the range

    • Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.

  • Other examples:

    • Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.

A review or change to the concept model is required with the scope of work impacting more than one attribute or range.

For example:

  • New concept model

    • Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.

  • Significant change to a current model e.g. Drug model





The type of issue/problem/project that needs to be worked on:

  • Quality improvement (analysis not required- noting below).

  • Alignment of content to the current Editorial guidance.



In addition to the above some other examples would be:

  • Quality improvement that requires analysis.

  • Sub hierarchy reviews

  • Clarification of meaning e.g. what is meant by repair, impairment

  • Smaller items of work managed by an Advisory group or project group.

In addition to the above some other examples would be:

  • Movement of content across hierarchies e.g. the issues relating to

  • Major policy decisions:

  • Larger items of work  managed by an Advisory group or project group.

    • X with Y, X due to Y



Analysis

Nil or a piece of work where a decision:

  • At the Internal Editors meeting

  • By the Head of Terminology, or

  • The Editorial Panel

would enable the solution to be determined and the work progressed. Note: this would be a decision that could be reached in a meeting, not one where analysis and extensive discussion would be required.

Analysis required.

Analysis required.



Solution testing before development

Not required

Required but can be done using current authoring tooling functionality in either the UAT or production environments.

Required



Impact of change:

  • Users- covered with stakeholder engagement dimension.

  • Terminology

  • Clinical

Terminology: Low or consequences of change can be determined and are positive. E.g. changing the modelling of a high level concept.

Clinical: To be determined

Terminology: Low - high. If medium to high: consequences of change can be determined (may be through solution testing) and are positive.

Clinical: To be determined.

Terminology: Medium to high.



Documentation: Please note content tracker documentation is under review and refinement.

  • Documentation within the JIRA issue on work undertaken is sufficient.

  • No Editorial guidance update is expected.

Content Tracker documentation required. This may be:

  • a fast track document

  • inception/elaboration document.

An update to Editorial Guidance may be part of the documentation required.

Project level documentation required. This may include Content Tracker documentation. An update to Editorial Guidance may be part of the documentation required.



Role/skills: This is not who must do work rather just an idea of the level of skills required given the potential complexity.

  • Intermediate to Experienced Authors or Senior Terminologists.

  • Tooling team support may be required e.g. a batch change but would be done as part of normal tool support.



  • Consultant Terminologist or Senior Terminologist. The Head of Terminology would sign off prior to construction.

  • Tooling support may be required e.g. a batch change but would be done as part of normal tool support.

  • Consultant Terminologist(s) or Senior Terminologist(s) plus the Head of Terminology.

  • Tooling team support may be required.





Resource implications: Resources may be required given the complexity of the issue and/or tooling support not just because of the number of concepts. Focus here has been effort over complexity and tooling support.

  • A work item that may be undertaken as part of normal daily activities through to a weeks worth of effort.

  • Some larger work items may still be considered issues given the other dimensions e.g. change is simple but more than a weeks effort is required.

A work item that may only require a few days work through to planned resources but can be managed within a release.



Requires planned resources over more than one or more releases with efforts by more than one staff member.



Stakeholder involvement required

  • Clinician input

  • Member consultation

While the CMAG or MF may be advised, input is not required.

May require SME, advisory group or requester input.

Consultation required.



Tooling

Current tooling functionality supports progression of the work item.

Current tooling functionality supports progression of the work item.

Simple changes e.g. a MRCM rule change would be acceptable for Problems.



Tooling change required.







Examples of potential trackers that may fit that category







Copyright © 2025, SNOMED International