Skip to content

pas-metrics docs: update release notes, document Notebook, add cross-links #35

Description

@qa-assist-bot

Gaps identified during QA review of HealthSamurai/smartbox#698:

DOC-01 (high): Release notes reference outdated version

releases.md line 31 says pas-metrics 0.1.2, available on request. Current version is 0.1.6 with a public download link. The entry should:

  • Update version to 0.1.6
  • Replace "available on request" with a link to the PAS Metrics page
  • Add release note entries for 0.1.5 (Metric 7 per-payer scoping) and 0.1.6 (Metric 4 exchange-level counting)

DOC-02 (high): Notebook resource not documented

The package ships Notebook-pas-metrics.json (11 cells: intro + interactive chart per metric). This is not mentioned in docs/analytics/pas-metrics.md. Users should know:

  • That the Notebook exists and what it provides
  • That it requires separate installation via PUT /Notebook/pas-metrics (since $fhir-package-install skips non-canonical resource types like Notebook)

DOC-03 (medium): No cross-link from PAS pillar page

docs/prior-auth/pas.md does not reference the PAS Metrics analytics page. A short mention (e.g., in a "See also" or "Analytics" subsection) would help PAS users discover the metrics capability.

DOC-04 (low): "Generated ids" wording

docs/analytics/pas-metrics.md line 114 says "the package installs with generated ids". The Library resources in the package have stable hardcoded id fields (e.g., metric-07-time-to-final-result). Users can reference them by ID directly. Consider removing or correcting this guidance.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions