Summary
When a requirement description contains a valid nested .. list-table::, the generated multi-page Lobster RST report escapes the table row markers (* - becomes \* -), and Sphinx/docutils then rejects the generated page.
Observed behavior
Generated file:
traceability_report/feature_requirements.rst
Error:
Error parsing content block for the "list-table" directive: exactly one bullet list expected.
In the generated report, the table body is rendered with escaped row markers like:
.. list-table::
:header-rows: 1
\* - #
- Mode 0
- Mode 1
instead of valid rows:
.. list-table::
:header-rows: 1
* - #
- Mode 0
- Mode 1
Expected behavior
Nested RST table content inside requirement text should remain valid in the generated traceability report.
Why this looks like a tooling bug
- The original requirement page renders the table correctly.
- The failure appears only in the generated Lobster RST report.
- The generated report escapes markup that must remain structural RST.
Impact
Valid migrated requirement content cannot be reused safely in Lobster-generated report pages if it contains structured RST tables.
Reproduction hint
A feature requirement with a description containing:
- prose
- a nested
.. list-table::
- normal
feature_requirements generation
- dependable element / Lobster traceability report generation
Suspected area
tools/lobster_rst_report rendering / escaping logic for requirement text embedded into report pages.
Summary
When a requirement description contains a valid nested
.. list-table::, the generated multi-page Lobster RST report escapes the table row markers (* -becomes\* -), and Sphinx/docutils then rejects the generated page.Observed behavior
Generated file:
traceability_report/feature_requirements.rstError:
Error parsing content block for the "list-table" directive: exactly one bullet list expected.In the generated report, the table body is rendered with escaped row markers like:
instead of valid rows:
Expected behavior
Nested RST table content inside requirement text should remain valid in the generated traceability report.
Why this looks like a tooling bug
Impact
Valid migrated requirement content cannot be reused safely in Lobster-generated report pages if it contains structured RST tables.
Reproduction hint
A feature requirement with a description containing:
.. list-table::feature_requirementsgenerationSuspected area
tools/lobster_rst_reportrendering / escaping logic for requirement text embedded into report pages.