-
Bug
-
Resolution: Done
-
Major
-
None
-
False
-
None
-
False
-
---
-
-
This is the tweaking PR for the better reusability of the TLS guide content.
These changes are being made based on QE feedback. CC Georgii Troitskii.
The visualization of the Quarkus TLS guide remains unchanged.
The issue now is that in order to render something correctly in RHBQ, I have to include a snippet that exists only in the RHBQ repository. Since we follow an "Upstream first" policy, I need to mention this include in the Quarkus documentation as well, even though it's wrapped in an `ifdef` condition, ensuring it doesn't affect Quarkus documentation (since the attribute that triggers the condition and the snippet itself are defined only in product repo).
Unfortunately, the GitHub docs preview bot fails because it attempts to locate the snippet that doesn’t exist in Quarkus, even though it’s not required.
```
Caused by: java.nio.file.NoSuchFileException: target/asciidoc/sources/resources/snippets/snip-note-derby.adoc
```
In my opinion, some changes will need to be made in `io.quarkus.docs.generation.AssembleDownstreamDocumentation`, which was likely written by @gsmet , whom I am kindly asking for advice/opinion/workaround.
Fix could be something like: When it is all about loading a file from the `resources/snippets/` folder, ignore it in the check.
This is not a blocker, but something that would be great to have.
- links to
-
RHBA-2024:10676 Red Hat build of Quarkus 3.15.2 release