-
Task
-
Resolution: Done
-
Major
-
None
-
None
The build of the 3.2 downstream documentation is currently blocked by several errors.
The following error prevents the build from completing successfully:
Opening and ending tag mismatch: emphasis line xxxxx and literal, line xxxxxx
It seems that the parser incorrectly interprets the use of the tick marks (`) that are used to format period (.) and underscore (_) characters in the examples of the JDBC connector naming transformations.
The combination of the underscore and the tick marks the same line apparently confuses the parser, which attempts to interpret them as formatting characters for applying emphasis and and monospace formatting.
Here's the original content:
`camel_case`::
Removes all `.` and `_` characters, and makes the immediate next character uppercase.
For example, the value `inventory.customers` would be changed to `inventoryCustomers`.`snake_case`::
Removes all `.` and replaces them with an `{}` character. Additionally, any numeric sequences will be prefixed with an `{}` while any capitalized character will be converted to lower case and prepended with an `_` character, too.
For example, the value `public.inventory` would become `public_inventory`, while `TopicWith123Numbers` would become `topic_with_123_numbers`.
To workaround the issue, I've enclosed these characters within parentheses, and applied passthrough formatting to the underscore characters, as shown in the following paragraphs:
Removes all period (`.`) and underscore (`_`) characters, and converts the immediate next character to uppercase.
Removes all period (`.`) characters and replaces them with underscore (`_`) characters.
Additionally, all numeric sequences are prefixed with an underscore (``), and all uppercase characters are converted to lowercase and then prefixed with an underscore (``) character.
In addition to the preceding problem, the Transformation topic fails to build.
To correct this issue, I've set the downstream Topic type, Title, and ModuleID attributes for the Transformations topic.
This issues also covers the following additional changes:
- Refactored the Transformations topic and converted 4th level heading to description list entries.
- To conform to terminology guidelines, I've converted instances of the terms upper case and lower case to one word.
- Applies miscellaneous editorial changes.