[docs] Enable PulumiCodeChooser on nested docs descriptions

[guineveresaenger]

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

With #15475 and pulumi/pulumi-terraform-bridge#1689, incoming schema description: fields on TF based providers now wrap all code blocks with <!--Start PulumiCodeChooser -->
and <!--End PulumiCodeChooser --> HTML tags.

This includes nested type descriptions! 🎉

We currently do not provide any handling for code blocks found in nested type descriptions, with can result in a rendered page stretching out all code blocks without a chooser.

More details:

I looked around a generated page with the new HTML tag wrappers looks like this:

<!-- raw HTML omitted -->
<pre><code class="language-typescript">import * as pulumi from &quot;@pulumi/pulumi&quot;;
import * as aws from &quot;@pulumi/aws&quot;;

const ecsPolicy = new aws.appautoscaling.Policy(&quot;ecsPolicy&quot;, {stepScalingPolicyConfiguration: {
    stepAdjustments: [
        {
            metricIntervalLowerBound: &quot;1&quot;,
            metricIntervalUpperBound: &quot;2&quot;,
            scalingAdjustment: -1,
        },
        {
            metricIntervalLowerBound: &quot;2&quot;,
            metricIntervalUpperBound: &quot;3&quot;,
            scalingAdjustment: 1,
        },
    ],
}});
</code></pre>
<pre><code class="language-python">import pulumi
import pulumi_aws as aws

ecs_policy = aws.appautoscaling.Policy(&quot;ecsPolicy&quot;, step_scaling_policy_configuration=aws.appautoscaling.PolicyStepScalingPolicyConfigurationArgs(
    step_adjustments=[
        aws.appautoscaling.PolicyStepScalingPolicyConfigurationStepAdjustmentArgs(
            metric_interval_lower_bound=&quot;1&quot;,
            metric_interval_upper_bound=&quot;2&quot;,
            scaling_adjustment=-1,
        ),
        aws.appautoscaling.PolicyStepScalingPolicyConfigurationStepAdjustmentArgs(
            metric_interval_lower_bound=&quot;2&quot;,
            metric_interval_upper_bound=&quot;3&quot;,
            scaling_adjustment=1,
        ),
        ...

and the <!-- raw HTML omitted --> seems to be replaced by our Markdown parser/renderer here.

A solution here would ensure that <!--Start PulumiCodeChooser -->" is recognized and swapped out for a real code chooser div. The tricky bit is recognizing the language highlight andsetting the language-specific choosable.

Affected area/feature

Docsgen