Typedoc: Support for @ignore?

Created on 23 Mar 2016  路  7Comments  路  Source: TypeStrong/typedoc

I assume that the syntax typedoc uses is based off jsdoc, but I have noticed that it doesn't support all the common features, in this instance the @ignore option which should omit the related variable/class/property etc from the documentation.

enhancement question

Most helpful comment

Using @hidden should cover this use case but I think adding an alias to @ignore to match jsdoc would make sense.

All 7 comments

It would be very useful. I tried exclude files, but in my case typedoc can't generate doc because missing references.

Did you try @hidden?

nope, will try that when I am back on the project. I find it odd though that in some areas it followed jsdoc and in others it just does its own thing.

Yeah, I was lucky to find this feature in source code.

Using @hidden should cover this use case but I think adding an alias to @ignore to match jsdoc would make sense.

it would also be nice if @hidden were documented on typedoc.org

Reviewing this, I think it would be good to alias JSDoc's @ignore option to TypeDoc's @hidden. As far as I can tell they both do the same thing. The action steps needed are:

  • [x] Adding @ignore as an alias of @hidden
  • [x] Document both options
Was this page helpful?
0 / 5 - 0 ratings