Docstrings of enum-like object members are missing

[ejuda]

Search terms

enum, enum-like object

Expected Behavior

Consider the following code:

// index.d.ts

/**
 * This enumeration defines some values.
 *
 * @enum
 */
export declare const SomeEnum: {
    /**
     * This is the auto property.
     */
    readonly AUTO: "auto";
    /**
     * This is the manual property.
     */
    readonly MANUAL: "manual";
};

Thanks to the PR closing issue #1740, TypeDoc correctly recognises this object as an enum. Both the docstring of the enum-like object and the docstrings of its members should also be preserved.

Actual Behavior

While the docstring of the enum-like object are preserved, those of its members are not:

The docstrings for AUTO and MANUAL members (This is the auto property and This is the manual property respectively) are missing from the page.

Steps to reproduce the bug

1. Clone the reproduction repository.
2. npm ci
3. npm run docs
4. This will generate documentation into docs directory.

Environment

• Typedoc version: 0.22.13
• TypeScript version: 4.6.2
• Node.js version: 16.14.0
• OS: Windows 10

[ejuda]

I think this has been mentioned in a comment on #1740, but I have not seen any issue with the follow-up on this.

[Gerrit0]

I think this should be an easy fix, just needs an update to https://github.com/TypeStrong/typedoc/blob/master/src/lib/converter/converter.ts#L187

[michkot]

Thanks a lot @ejuda, I ultimately didn't make the time to report it properly!