...
Note for Vertical Tables: The comparison tool will not show the differences in dependencies (see Anchor
| Table of Contents | ||
|---|---|---|
|
, but it will not apply them (see “Vertical tables”).
Tables and lists
We don’t flatten lists and tables anymore.
...
Rationale: Customers complained that we reformatted documents in v1, and images were reduced to their minimum, so we store the image as rendered by Confluence.
Vertical
...
tables and parent/child dependencies
In Indexing V1, we used to create automatic parent/child dependencies between vertical tables and the following requirements.
Bug scenario: The comparison tool doesn’t show the differences, and upgrading those requirements doesn’t change their dependencies, but the next time they are indexed, dependencies will have changed.
...
Recursive macros,
Repeat macros,
Excerpt/include macros with definitions: They will appear as duplicate definitions if they appear on several pages.
There is extra HTML added to my requirements
We save more HTML than before, and it sometimes leads to HTML such as div class=”content-wrapper”> to be inserted:
...
Bug scenario: None. The rendered content is the same and it just occupies more space in a database.
Rationale: We ackowledge those elements are visually polluting. However, there are added by Confluence and we have technical difficulties identifying them using a streaming parser (it would be easy using a DOM parser, but we try not to load the full XML of pages in RAM). Since they don’t cause issues, we don’t consider it a bug when they are present.