Skip to content

Add a description to the SystemReady Devicetree categories#635

Open
vstehle wants to merge 2 commits intoARM-software:mainfrom
vstehle:cats
Open

Add a description to the SystemReady Devicetree categories#635
vstehle wants to merge 2 commits intoARM-software:mainfrom
vstehle:cats

Conversation

@vstehle
Copy link
Contributor

@vstehle vstehle commented Feb 6, 2026

This is done in two steps:

  1. Add a schema to capture the original format of test_categoryDT.json as it is
  2. Add the descriptions while updating the schema

Ultimately those descriptions should end up into the tests results JSON and HTML files, to be visible by test engineers.

The schema is not applicable to test_category.json as the formats differ.

Add a JSON schema describing the format of test_categoryDT.json.

The following example command can be used for validation, from the
common/log_parser folder:

  $ check-jsonschema --schemafile test_categoryDT-schema.json \
      test_categoryDT.json

Signed-off-by: Vincent Stehlé <vincent.stehle@arm.com>
Add a `Description' field to each test suite in test_categoryDT.json.

This is meant to help test engineers better understand the implication of
each test suite's failures on system quality.

The JSON format does not allow to break long lines. Therefore, to keep the
file human-readable, the description is recorded as an array of strings,
with one string corresponding to one sentence.

While at it, update the schema.

Signed-off-by: Vincent Stehlé <vincent.stehle@arm.com>
@vstehle
Copy link
Contributor Author

vstehle commented Feb 6, 2026

Hi @chetan-rathore and @pergar01, could you please have a look?

Test suites are never perfectly documented regarding what they test exactly. Therefore, feel free to add even more details.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant