Documenting your API

Attention

These docs are for Scribe for JS v1, which is no longer maintained. See scribe.knuckles.wtf/nodejs for Scribe for JS v2.

Scribe tries to infer information about your API from your code, but you can enrich this information in the config and by using annotations (tags in doc block comments).

Important

For Express and Restify routes, the docblock needs to be on the route declaration, not the function declaration. For instance:

Excluding endpoints from the documentation

You can exclude endpoints from the documentation by using the @hideFromApiDocs tag in the relevant doc block (on the route declaration). Scribe will not extract any information about the route or add it to the generated docs.