Ensure relative links in markdown are interpreted

[radeksimko]

Context

As described in hashicorp/terraform#34510 the Markdown descriptions, which includes both provider schema and any (core or future provider) functions, may contain relative links.

This is not currently handled in any way, i.e. we just keep the links as-is.

One example is sensitive function:

terraform-schema/internal/funcs/0.15/functions.go

Line 46 in 1ed5c20

Description: "`sensitive` takes any value and returns a copy of it marked so that Terraform will treat it as sensitive, with the same meaning and behavior as for [sensitive input variables](/language/values/variables#suppressing-values-in-cli-output).",

The result is the following unfortunate UX:

Proposal

While the problem is surfaced to the user in the language server, I believe that the links should get resolved into absolute ones as soon as the JSON output is consumed and turned into Go as it I think it may get more difficult afterwards.

I leave it up to you to decide on the solution though - I'm just providing context on why I filed the issue here and not in terraform-ls.

Related

• Include base URL for docs links in machine-readable output terraform#34660