Skip to content

[Feature]: Readable labels for requirements: detect the id and text attributes  #68

Open

Description

@samatstariongroup

What type of issue is this?

  • Bug report
  • Feature request

Prerequisites

  • I have written a descriptive issue title
  • I have verified that I am running the latest version of the reqifviewer
  • I have searched open and closed issues to ensure it has not already been reported

Description

In the Subset026 sample the specification tree reads "16", "292230", "134", "3275"...: the label falls back to the first attribute value, which there is an internal Word trace id. The meaningful id (requirementID = "3.4.2.2.2[2].[f]1") and the text are in the file but not used.

Proposed heuristics, in order: the attribute names from the ReqIF Implementation Guide (ReqIF.ForeignID for the id, ReqIF.ChapterName for headings, ReqIF.Text for the text); attribute names containing "id"; the first XHTML attribute for the text.

Acceptance criteria

  • Per spec type, the viewer picks an "id" attribute and a "text" attribute using the heuristics described above, and a "heading" attribute for chapters.
  • The user can change the choice per spec type; it is remembered per file (browser storage).
  • Every list, tree, search result and trace uses these labels; internal identifiers appear only in the inspector.
  • Tested against both sample files (the Subset026 tree shows "3.4.2.2.2[2].[f]1"-style ids and the text, not "16").

Steps to Reproduce

Load requirements-and-objects.reqifz or ProR_Traceability-Template-v1.0.reqif (reqifviewer.Tests/TestData) and look at the pages mentioned above.

System Configuration

Activity

  1. added
    enhancementNew feature or request
    phase-1Improvement plan phase 1: reader experience
    uxUser experience and design
    needs-decisionNeeds a maintainer decision before work starts
    on Oct 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestneeds-decisionNeeds a maintainer decision before work startsphase-1Improvement plan phase 1: reader experienceuxUser experience and design

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions