209 params json to adoc

[james-ball-qualcomm]

Creating script to convert params.json into adoc files suitable for a CRD appendix

[Copilot]

Pull request overview

Adds a new tool to generate AsciiDoc appendix fragments from params.json and refactors existing tools to share common loaders/validators via a new shared_utils.py helper module.

Changes:

• Introduces tools/create_param_appendix.py to emit one .adoc table-row fragment per parameter for CRD appendix inclusion.
• Adds tools/shared_utils.py and refactors create_params.py / create_normative_rules.py to reuse shared JSON/YAML loading, logging, and kind/category validation.
• Expands test coverage and build automation (new unit tests, updated expected outputs, new Makefile targets) and removes archived Ruby tooling/docs in favor of consolidated tools/README.md.

Reviewed changes

Copilot reviewed 52 out of 52 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
tools/shared_utils.py	New shared constants + logging + JSON/YAML loaders + validators/formatters reused by tools.
tools/create_params.py	Refactored to use shared helpers; updates HTML “feature” column and info labeling.
tools/create_param_appendix.py	New generator producing per-parameter AsciiDoc fragments from params.json.
tools/create_normative_rules.py	Refactored to use shared helpers; minor HTML labeling text updates.
tools/archive/detect_tag_changes.rb	Removed archived Ruby script.
tools/archive/create_normative_rules.rb	Removed archived Ruby implementation.
tools/README_detect_tag_changes.md	Removed in favor of consolidated tools README.
tools/README.md	New consolidated documentation for tools directory.
tests/text_to_html/test_tag_text_to_html_unit.py	New unit tests for tag_text_to_html.py.
tests/text_to_html/test_def_text_to_html_unit.py	New unit tests for def_text_to_html.py.
tests/text_to_html/test_adoc_to_html_unit.py	New unit tests for adoc_to_html.py.
tests/shared_utils/test_shared_utils.py	New unit tests for shared_utils.py.
tests/params/test_param_appendix.py	New integration-style test to assemble a combined appendix from generated fragments.
tests/params/test-param-appendix-template.adoc	Template used by appendix assembly test.
tests/params/test-ch2.yaml	Adds additional parameters used by updated expected outputs.
tests/params/expected/test-params.json	Updated expected params JSON output.
tests/params/expected/test-params.html	Updated expected params HTML output.
tests/params/expected/test-param-appendix.adoc	New expected combined appendix output.
tests/params/expected/test-param-appendix-adoc-includes/*	New expected per-parameter fragment outputs.
tests/norm-rule/test-ch2.yaml	Adds additional normative-rule defs used by params/appendix tests.
tests/norm-rule/test-ch2.adoc	Updates section title and adds new tags for appended rules.
tests/norm-rule/test-ch1.yaml	Updates instances and adds FOOBAR rule.
tests/norm-rule/test-ch1.adoc	Adds FOOBAR tag text.
tests/norm-rule/expected/test-norm-rules.json	Updated expected normative-rules JSON output.
tests/norm-rule/expected/test-norm-rules.html	Updated expected normative-rules HTML output.
tests/norm-rule/expected/test-ch2-norm-tags.json	Updated expected extracted tags for chapter 2.
tests/norm-rule/expected/test-ch1-norm-tags.json	Updated expected extracted tags for chapter 1.
Makefile	Adds targets to build/compare appendix outputs and run new unit tests.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.