diff --git a/docs/src/main/asciidoc/all-builditems.adoc b/docs/src/main/asciidoc/all-builditems.adoc index 37d6431639e6c9..888b264ae688fd 100644 --- a/docs/src/main/asciidoc/all-builditems.adoc +++ b/docs/src/main/asciidoc/all-builditems.adoc @@ -11,6 +11,8 @@ include::_attributes.adoc[] :categories: writing-extensions :summary: Explore all the BuildItems you can consume/produce in your extensions. -Here you can find a list of Build Items and the extension that provides them: +Here you can find a list of Build Items and the extension that provides them. + +icon:lock[title=Non-instantiatable Build Item] Build item can't be instantiated directly, but can be extended/inherited from include::{generated-dir}/config/quarkus-all-build-items.adoc[opts=optional] diff --git a/docs/src/main/java/io/quarkus/docs/generation/QuarkusBuildItemDoc.java b/docs/src/main/java/io/quarkus/docs/generation/QuarkusBuildItemDoc.java index 141a144fd2dc87..82dddeefad83b4 100644 --- a/docs/src/main/java/io/quarkus/docs/generation/QuarkusBuildItemDoc.java +++ b/docs/src/main/java/io/quarkus/docs/generation/QuarkusBuildItemDoc.java @@ -186,8 +186,11 @@ private void printTableRow(Pair pair) { String className = source.getQualifiedName(); String attributes = buildAttributes(source); String description = getJavaDoc(source); + String baseBuildItemText = source.isAbstract() + ? "icon:lock[title=Non-instantiatable Build Item (can be inherited from)]" + : ""; - out.println("a| " + link + "[`" + className + "`, window=\"_blank\"] :: +++" + + out.println("a|" + baseBuildItemText + " " + link + "[`" + className + "`, window=\"_blank\"] :: +++" + javadocToHTML(description) + "+++"); out.println("a| " + attributes); }