• I have tried restarting my IDE and the issue persists.
• I have updated to the latest version of the packages.
• I haveread the FAQ and my problem is not listed.

Repro

not applicable

Expected Result

not applicable

Actual Result

not applicable

Additional Info

This is a meta issue about documentation.

I couldn't find any information about the AST node types, especially the ones that are Typescript-specific. For example, if I'm extending a rule and I come across a place where it's dealing withTSTypeParameterInstantiation - how do I know what that means? Ideally, it would be great to have a gallery with code snippets (examples) for every available node type. I know that's a great effort, but even starting to add some JSDoc comments with very brief explanations or short snippets to the code would help a lot.

Here's an example of what I'm thinking of:

Before

exportinterfaceCallExpressionextendsCallExpressionBase{type:AST_NODE_TYPES.CallExpression;}

After

/** * A function/method call. *@example function1<Type1>(arg1); */exportinterfaceCallExpressionextendsCallExpressionBase{type:AST_NODE_TYPES.CallExpression;}

Of course, that's an easy example, everyone knows what a call expression is. But for more complex types, this would make writing rules significantly easier.

Versions