DMTF / Redfish-Tools

DMTF-produced tools to support the Redfish Specification
Other
81 stars 35 forks source link

Odd combined table output on `TLSParameterSet` in SecurityPolicy schema #468

Open jautor opened 7 months ago

jautor commented 7 months ago

Doc generator output in Markdown mode (doesn't seem to appear in HTML output) has an odd table formatting for an embedded object that has been "promoted" to a shared object definition for that resource.

This shows up in the Redfish SecurityPolicy schema definition, which has 6 instances of properties sharing the TLSParameterSet object definition. The table added in "Property Details" for TLSParameterSet has multiple extraneous columns which compress the available column width. This is most evident when the normative output mode is used (the LongDescription text for the properties within that object are lengthy).

I have not determined if this is an issue unique to this particular schema or object, as this re-use of an object (also embedded in another object) may be unique across all schema definitions. Note that the "common object" function itself works fine - for example, Protocol in ManagerNetworkProtocol, is used >8 times but the property details table is normal.