Gerrit Birkeland

> `type IsAssignable = T extends U ? true : false` This isn't a good implementation. With `IsAssignable` it gives `boolean` because `T` is a bare type parameter and we...

New as of 3.7 - https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-7.html#the-usedefineforclassfields-flag-and-the-declare-property-modifier

Yep, that was the idea

Perhaps just a checkbox to pick one one behavior or the other? I agree that it definitely would add friction with a small number of files transferred (

If this is specified as valid, what would documented types look like? Right now both api-extractor and typedoc just display the type. Do we need special casing for unions? Are...

Note: TypeDoc != TSDoc. This hasn't been added to the TSDoc standard yet, but TypeDoc plans to support it. Other documentation generators might not necessarily support it.

I believe the best documentation for this right now is in the source of this library: https://github.com/microsoft/tsdoc/blob/master/tsdoc/src/details/StandardTags.ts You can also look at the documentation for API Extractor, but there are...

From the table Octogonz posted above: pipe-and-dash tables | unsupported | ``| We're not planning to support GitHub tables because CommonMark doesn't support them either. We will recommend to use...

TSDoc is only concerned with parsing comments. TypeScript provides the type information. Any documentation generator will need to interact with the TypeScript compiler API to iterate through documentable nodes and...

An additional point to consider when reviewing the dot syntax is the values might not be valid identifiers. When describing a tuple type, it would be great to be able...