Skip to content

Conversation

@maxwelldb
Copy link
Contributor

This file must never be merged.

This file must never be merged.
@openshift-ci openshift-ci bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Dec 17, 2025
@ocpdocs-previewbot
Copy link

ocpdocs-previewbot commented Dec 17, 2025

🤖 Fri Dec 19 22:15:59 - Prow CI generated the docs preview:

https://104108--ocpdocs-pr.netlify.app/

@maxwelldb
Copy link
Contributor Author

/retest

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.ContentType: The '_mod-docs-content-type' attribute definition is missing.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.ShortDescription: Assign [role="_abstract"] to a paragraph to use it as in DITA.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.ModuleContainsContentType: Module is missing the '_mod-docs-content-type' variable.

@@ -0,0 +1,66 @@
// NO parent assembly comment - violates ModuleContainsParentAssemblyComment
[id="problematic-vale-test"]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.IdHasContextVariable: ID is missing the '_{context}' variable at the end of the ID.

// NO parent assembly comment - violates ModuleContainsParentAssemblyComment
[id="problematic-vale-test"]
= Problematic Vale Test Module
John Smith <jsmith@example.com>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.AuthorLine: Author lines are not supported for topics.


ID missing _{context} - violates IdHasContextVariable.

.NOTE: This is an admonition title
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.AdmonitionTitle: Admonition titles are not supported in DITA.


ID missing _{context} - violates IdHasContextVariable.

.NOTE: This is an admonition title
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.BlockTitle: Block titles can only be assigned to examples, figures, and tables in DITA.

== Nested Section Inside Module
This violates NoNestingInModules - modules should not have section headings.

=== Doubly Nested Section
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.NestedSection: Level 2, 3, 4, and 5 sections are not supported in DITA.

Even worse nesting.

.Additional resources
This additional resources section is missing the role attribute - violates AdditionalResourcesHeadingHasRoleID.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

.Additional resources
This additional resources section is missing the role attribute - violates AdditionalResourcesHeadingHasRoleID.

* xref:some-other-file.adoc[A naked xref label] - violates XrefMustNotHaveNakedLabel
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

.Additional resources
This additional resources section is missing the role attribute - violates AdditionalResourcesHeadingHasRoleID.

* xref:some-other-file.adoc[A naked xref label] - violates XrefMustNotHaveNakedLabel
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.XrefContainsAnchorID: The xref is missing an anchor ID.

This additional resources section is missing the role attribute - violates AdditionalResourcesHeadingHasRoleID.

* xref:some-other-file.adoc[A naked xref label] - violates XrefMustNotHaveNakedLabel
* xref:another-file#some-anchor[Link] - this xref contains HTML-style anchor - violates XrefContainsHTML
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.


* xref:some-other-file.adoc[A naked xref label] - violates XrefMustNotHaveNakedLabel
* xref:another-file#some-anchor[Link] - this xref contains HTML-style anchor - violates XrefContainsHTML
* link:https://example.com[Click here] - external link in a module
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

* xref:another-file#some-anchor[Link] - this xref contains HTML-style anchor - violates XrefContainsHTML
* link:https://example.com[Click here] - external link in a module

include::snippets/some-snippet.adoc[lines=1..5]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

* xref:another-file#some-anchor[Link] - this xref contains HTML-style anchor - violates XrefContainsHTML
* link:https://example.com[Click here] - external link in a module

include::snippets/some-snippet.adoc[lines=1..5]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.NoLineRanges: Do not use line ranges for included files.


include::snippets/some-snippet.adoc[lines=1..5]

[source,terminal]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

include::snippets/some-snippet.adoc[lines=1..5]

[source,terminal]
----
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.


[source,terminal]
----
oc get pods
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

[source,terminal]
----
oc get pods
----
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

oc get pods
----

This is a line that is exactly eighty characters long and ends without punctuat
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

----

This is a line that is exactly eighty characters long and ends without punctuat
This continues on a new line - violates HardWrappedLines.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

This is a line that is exactly eighty characters long and ends without punctuat
This continues on a new line - violates HardWrappedLines.

Here is a thematic break which is not supported:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.


Here is a thematic break which is not supported:

'''
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.ThematicBreak: Thematic breaks are not supported in DITA.


Here is a thematic break which is not supported:

'''
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.


'''

And a page break:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.


And a page break:

<<<
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.PageBreak: Page breaks are not supported in DITA.


And a page break:

<<<
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.


<<<

Some text with {custom-attribute-reference} that might not resolve.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.


Some text with {custom-attribute-reference} that might not resolve.

[sidebar]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.SidebarBlock: Sidebars are not supported in DITA.


Some text with {custom-attribute-reference} that might not resolve.

[sidebar]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

Some text with {custom-attribute-reference} that might not resolve.

[sidebar]
This is a sidebar block which is not supported in DITA.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

[sidebar]
This is a sidebar block which is not supported in DITA.

----
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

This is a sidebar block which is not supported in DITA.

----
This is a listing block
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.


----
This is a listing block
with a trailing backslash \
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

----
This is a listing block
with a trailing backslash \
which might cause issues
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

This is a listing block
with a trailing backslash \
which might cause issues
----
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.RelatedLinks: Content other than links cannot be mapped to DITA related-links.

----

.Example block title
====
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] AsciiDocDITA.ExampleBlock: Examples can not be inside of other blocks in DITA.

Example blocks need special handling.
====

toc::[]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [error] OpenShiftAsciiDoc.NoTocInModules: Do not include TOCs in modules, only assemblies.

@maxwelldb maxwelldb closed this Dec 19, 2025
@maxwelldb maxwelldb reopened this Dec 19, 2025
@openshift-ci
Copy link

openshift-ci bot commented Dec 19, 2025

@maxwelldb: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants