Skip to content

Add implementation metadata. #25

@davidlehn

Description

@davidlehn

The generated test suite output table just has a text field for the columns. Readers need more data on what this text refers to. Right now it's displaying the name field, and the implementation field is not used? I'd suggest adding more optional metadata in the implementation JSON files. It might make more sense for the test result table columns to use the implementation text field instead. Then have another table that maps that implementation name to the implementer name, with optional link to their URL, the implementation, with optional link to its URL, an optional implementation version/date if appropriate, and maybe optional implementation notes. Most details should be left to implementers to put on their own sites, but at least need links to those sites. All this would greatly help readers to know what is being tested and where to find more info.

While maybe this should be using EARL and DOAP for properties, a quick freeform schema could be:

  • implementation: name of the implementation
  • [implementationUrl]: optional URL for implementation
  • implementer: name of implementer (company, organization, person, etc)
  • [implementerUrl]: optional URL for implementer
  • [version]: optional implementation version (this may be difficult if using live services)
  • [date]: optional implementation date (this may be difficult if using live services)
  • [notes]: optional notes (anything brief for a table, but leave most details at the implementation URLs)

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