[FEATURE]: Generate a browsable documentation for the protobuf specification

[andreas-hilti]

Describe the feature

Generate a browsable documentation for the protobuf specification.

For JSON and XML, you already have a browsable documentation of the specification, i.e.
https://cyclonedx.org/docs/1.6/json/#
and
https://cyclonedx.org/docs/1.6/xml/
I think it would be valuable to have something similar also for the protobuf specification.

Possible solutions

You can use for instance https://github.com/pseudomuto/protoc-gen-doc.
Using
protoc.exe --doc_out=./docgen/proto --doc_opt=html,index.html schema/bom-1.6.proto
this generates:
index.zip

(This was only a quick first shot, you can also further customize it.)

Alternatives

There might be other documentation generators, but I don't know them.
An alternative is also to provide only the raw proto file (but this is not very attractive IMO).

Additional context

[jkowalleck]

• basic docs are generated from proto schema files - docs: docgen proto with protoc-gen-doc #557
• they need to be themed (add navigation bar) - docs: docsgen theme and linkd for proto #571
• and uploaded to the website -- https://github.com/CycloneDX/cyclonedx.org-website/pull/15

i am on it

[jkowalleck]

the rendered docs are available here:
https://cyclonedx.org/docs/latest/proto/