-
Sub-task
-
Resolution: Unresolved
-
Major
-
None
-
None
-
False
-
-
False
-
-
In preparation for migrating Red Hat documentation sources to DITA, it's necessary to modify some of the AsciiDoc sources in the Debezium community GitHub repository.
This issue tracks removal of callout markup in code blocks.
DITA does not include dedicated semantic markup for callouts. Although the tooling that we'll use to convert the AsciiDoc sources to DITA supports callouts, based on competitive analysis, as well as requirements to support accessibility and AI consumption of the content, the Red Hat content services team has decided that we should remove callouts before we migrate content to DITA.
Callouts to be removed
The following list identifies callouts scheduled for removal.
Configuration
- signalling.adoc (L400. L423)
Connectors
- db2.adoc (L2479)
- informix.adoc (L1917)
- mongodb.adoc (L1520)
- oracle.adoc (L3428, L5522)
- postgresql.adoc (L2352, L2361, L3023)
- spanner.adoc (L920)
- sqlserver.adoc (L2467)
- vitess.adoc (L1285, L1338)
Transformations
- timescaledb.adoc (L136, L194)
Shared partials
- shared-mariadb-mysql.adoc (L2865)
- proc-registering-conector-monitor-inventory-database.adoc (L52, L166)
- proc-starting-kafka-connect.adoc (L90, L101)
- proc-starting-kafka.adoc (L97)
Note: The preceding list omits instances of callouts that occur in the following upstream-only files:
- integrations/testcontainers.adoc
- postgres-plugins.adoc