Revisit doc structure and headings

[nedmsmith]

Taking a step back, the document structure may need some tweaking:

• Section 5 heading should be "CoRIM-based Appraisal" or something similar since it isn't exclusive to Evidence.

  • Section 5.4.5 Adding CoMID Endorsed values to ACS : should be removed or integrated with Section 5.4.3 Processing Endorsed Value Triple since these appear to be synonymous.
  • There should be a section between Section 5.4.1 and 5.4.2 that describes "Adding Evidence to ACS".
  • There should be a section (5.4.5?) that describes processing of CoSWID tags and coswid-triples that also closes issue coswid appraisal conventions #165.

• Section 5.5 should be "Transforming Evidence" or something similar since other sections in 5 (see previous bullets) describe initialization and population of ACS with Evidence and 5.5 focuses on schema mapping issues.

  • There should be a section 5.5.3 "Transforming EAT Evidence" (and the other similarly named subsections can be shortened so the heading is less wordy. (e.g.: "Transforming DICE Evidence", and "Transforming SPDM Evidence",...)
  • Similarly, Section 5.5.4 "Transforming Concise Evidence" for https://trustedcomputinggroup.org/wp-content/uploads/TCG-DICE-Concise-Evidence-Binding-for-SPDM-Version-1.0-Revision-54_pub.pdf

• There should be a new Section 6 that focuses on processing updates e.g., "Update Processing". The resolution to PR Updates to Reference Value and Endorsed Values #170 should be documented here. Subsections might be:

  • Section 6.1 Updates Can Take Multiple Forms : This section describes the various possible ways the ecosystem might update RIMs (e.g.: x-triples, x-corims, refreshed corims, x-tags?...)
  • Section 6.2 Staging Updates : This section describes a staging area for applying updates and results in an internal representation of RVPs and Endorsements suitable for use by appraisal (section 5).
  • If there is a need to describe in more detail a particular update mechanism (e.g. x-triple) then subsections here can describe semantics and CDDL expressions.