Documentation string not included in generated code

[nicl]

❓ Guidance

Affected Languages

• TypeScript or Javascript
• Python
• Java
• .NET (C#, F#, ...)
• Go

General Information

• JSII Version: 1.51.0
• Platform: OSX

The Question

I would like Typescript docs for structs, members, etc., to carry over into the generated Java (and other) code.

E.g. for Typescript like

export interface Foo {
    /**
     * bar means something that I want to describe.
     */
    readonly bar: string;
}

I was expecting the bar means something that I want to describe. description to be carried over to the generated Java code, but it is not. E.g. I was hoping for something like this:

/**
 * bar means something that I want to describe.
 */
public Foo.Builder bar(String bar) {
    this.bar = bar;
    return this;
}

What is the recommended way to reuse documentation from the source Typescript into generated code?

Thanks.