Update YAML metadata generation for asciidoc files

[ebullient]

Resolves #28480

errorsByFile.yaml:

.../docs/src/main/asciidoc/lra.adoc:
- Document does not have a preamble.
- Document does not follow naming conventions (type not recognized).
- Document does not define an id.
- Document does not specify associated categories

indexByFile.yaml:

...
doc-contribute-docs-howto.adoc:
  title: How to contribute documentation
  filename: doc-contribute-docs-howto.adoc
  summary: Outline the recommended steps for making successful contributions to Quarkus
    documentation.
  categories:
  - contributing
  id: howto-contribute-docs
  type: howto
...

indexByType.yaml:

types:
  reference:
    id: reference
    name: Reference
    index:
      ...
      doc-reference.adoc:
        title: About Quarkus documentation
        filename: doc-reference.adoc
        summary: A detailed reference for the structure and composition of Quarkus
          documentation.
        categories:
        - contributing
        id: reference-doc-quarkus-documentation
        type: reference
      ...

[gsmet]

Ah sorry I was too quick to merge. Thought you might want this in sooner rather than later. @maxandersen @michelle-purcell feel free to comment, if there's a big issue, I'll rollback and create a new PR.

[ebullient]

I think we can fail forward, @gsmet. :) Thank you!