Cross-link Javadocs in reference API docs

Hello!

• Vote on this issue by adding a 👍 reaction
• If you want to implement this feature, comment to let us know (we'll work with you on design, scheduling, etc.)

Issue details

Once we publish javadocs we need to fill in the following placeholder so that API docs can link to the javadocs.

// TODO revisit once javadocs are published.
//
// Not every language currently supports this. For Python docsgen the
// implementation returns "" also.
//
// For an example of a language that supports this, check out Go.
//
// When visiting https://www.pulumi.com/registry/packages/aws/api-docs/s3/bucket/ see:
//
//     func NewBucket(ctx *Context, name string, args *BucketArgs, opts ...ResourceOption)
//
// Context, BucketARgs and ResourceOption get linked to Go API docs.
//
// For Java we could link to JavaDoc when appropriate.
func (d DocLanguageHelper) GetDocLinkForPulumiType(pkg *schema.Package, typeName string) string {
	return ""
}

Affected area/feature

Start at DocLanguageHelper.GetDocLinkForPulumiType, the entry point named in the issue, and compare it with the Go implementation mentioned there. Investigate how JavaDocs are published and how Java type names map to their API documentation. Done means generated reference API pages link relevant Java types to the published JavaDocs.