Broken and missing Javadoc for some build items on https://quarkus.io/guides/all-builditems

[holly-cummins]

Describe the bug

Since the build item javadoc is effectively our SPI to extension authors, and since it's all published at https://quarkus.io/guides/all-builditems, we want it to be complete and informative, and not have weird formatting defects where content stops in the middle of a sentence because links aren't displayed.

We had a big improvement to our javadoc @nderwin in 9713f7f (yay!). However, I think Nathan focused more on improving the wording of what we already had, rather than filling in blanks or correcting a formatting big. Nathan's improvements are not reflected on the live site yet, but hopefully I didn't duplicate things he's fixed.

Broken javadoc

Often, for these, the source code looks ok, but something is messing up the formatting, usually where we use a link in the javadoc.

• io.quarkus.deployment.pkg.builditem.BuildSystemTargetBuildItem

• io.quarkus.deployment.builditem.DevServicesLauncherConfigResultBuildItem

• io.quarkus.deployment.builditem.nativeimage.ForceNonWeakReflectiveClassBuildItem (everything after creating in

 * {@code ReflectiveClassBuildItem}

is not displayed

-io.quarkus.deployment.builditem.nativeimage.NativeImageAllowIncompleteClasspathAggregateBuildItem

• io.quarkus.deployment.builditem.nativeimage.NativeImageResourceBuildItem

• io.quarkus.deployment.builditem.nativeimage.ReflectiveHierarchyBuildItem (not terrible, but the list isn't right)

• io.quarkus.deployment.builditem.RunTimeConfigBuilderBuildItem

• io.quarkus.deployment.builditem.StaticInitConfigBuilderBuildItem

Missing javadoc

• io.quarkus.deployment.builditem.AdditionalClassLoaderResourcesBuildItem
• io.quarkus.deployment.builditem.AppModelProviderBuildItem
• io.quarkus.deployment.builditem.ApplicationArchivesBuildItem
• io.quarkus.deployment.builditem.ApplicationClassNameBuildItem
• io.quarkus.deployment.builditem.ApplicationInfoBuildItem
• io.quarkus.deployment.builditem.ArchiveRootBuildItem
• io.quarkus.deployment.BooleanSupplierFactoryBuildItem
• io.quarkus.deployment.builditem.BytecodeRecorderObjectLoaderBuildItem
• io.quarkus.deployment.builditem.BytecodeTransformerBuildItem
• io.quarkus.deployment.pkg.builditem.CompiledJavaVersionBuildItem
• io.quarkus.deployment.builditem.ConfigClassBuildItem
• io.quarkus.deployment.builditem.ConfigMappingBuildItem
• io.quarkus.deployment.builditem.ConfigPropertiesBuildItem
• io.quarkus.deployment.builditem.ConsoleCommandBuildItem
• io.quarkus.deployment.builditem.ConsoleFormatterBannerBuildItem
• io.quarkus.deployment.builditem.ContextHandlerBuildItem
• io.quarkus.deployment.pkg.builditem.CurateOutcomeBuildItem
• io.quarkus.deployment.cmd.DeployCommandActionBuildItem
• io.quarkus.deployment.cmd.DeployCommandActionResultBuildItem
• io.quarkus.deployment.cmd.DeployCommandDeclarationResultBuildItem
• io.quarkus.deployment.pkg.builditem.DeploymentResultBuildItem
• io.quarkus.deployment.dev.devservices.DevServiceDescriptionBuildItem
• io.quarkus.deployment.builditem.DockerStatusBuildItem
• io.quarkus.deployment.builditem.ExtensionSslNativeSupportBuildItem
• io.quarkus.deployment.builditem.GeneratedClassBuildItem
• io.quarkus.deployment.builditem.GeneratedResourceBuildItem
• io.quarkus.deployment.pkg.builditem.JarBuildItem
• io.quarkus.deployment.builditem.JavaLibraryPathAdditionalPathBuildItem
• io.quarkus.deployment.builditem.JniBuildItem
• io.quarkus.deployment.builditem.LogCategoryMinLevelDefaultsBuildItem
• io.quarkus.deployment.logging.LogStreamBuildItem
• io.quarkus.deployment.builditem.MainBytecodeRecorderBuildItem
• io.quarkus.deployment.builditem.MainClassBuildItem
• io.quarkus.deployment.metrics.MetricsCapabilityBuildItem
• io.quarkus.deployment.pkg.builditem.NativeImageBuildItem
• io.quarkus.deployment.builditem.nativeimage.NativeImageConfigBuildItem
• io.quarkus.deployment.builditem.NativeImageEnableAllCharsetsBuildItem
• io.quarkus.deployment.builditem.QuarkusApplicationClassBuildItem
• io.quarkus.deployment.builditem.QuarkusBuildCloseablesBuildItem
• io.quarkus.deployment.builditem.nativeimage.ReflectiveFieldBuildItem
• io.quarkus.deployment.builditem.nativeimage.ReflectiveMethodBuildItem
• io.quarkus.deployment.cmd.RunCommandActionBuildItem
• io.quarkus.deployment.cmd.RunCommandActionResultBuildItem
• io.quarkus.deployment.builditem.ShutdownListenerBuildItem
• io.quarkus.deployment.builditem.SslNativeConfigBuildItem
• io.quarkus.deployment.builditem.StaticBytecodeRecorderBuildItem
• io.quarkus.deployment.dev.testing.TestListenerBuildItem
• io.quarkus.deployment.builditem.ThreadFactoryBuildItem
• io.quarkus.deployment.builditem.nativeimage.UnsafeAccessedFieldBuildItem

[quarkus-bot]

/cc @MichalMaler (documentation), @ebullient (documentation), @inoxx03 (documentation), @michelle-purcell (documentation), @rolfedh (documentation), @sheilamjones (documentation), @sunayna15 (documentation)