skills/angular__angular
1
0
Fork 0
mirror of https://github.com/angular/angular.git synced 2026-09-14 13:54:52 +08:00
Code Issues Packages Projects Releases Wiki Activity

chore: remove outdated guide to generate docs (#4123)

Browse Source
This commit is contained in:
Paul Gschwendtner
2017-04-17 21:11:49 +02:00
committed by Jeremy Elbourn
parent 25a688106c
commit d20a4ca3fa
1 changed files with 0 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files
GENERATING_API_DOCS.md
-30
View File
@@ -1,30 +0,0 @@
# Generating API Docs with Typedoc
[Typedoc](http://typedoc.org/) is a documentation generator for TypeScript projects.
Refer to `typedoc.json` for build configuration.
1. `npm install`
2. `npm run api`
TypeDoc will leverage the typings file to generate docs. The output will be located in `/dist/api/api.json`.
## FAQ
### How do I stop HTML generation and focus only on JSON?
Currently not possible, submitted a feature request: https://github.com/TypeStrong/typedoc/issues/337
### How do I prevent `Cannot find name` errors?
When typedoc is invoked tsconfig and typings file must be in the path.
### How do we omit constructors or other methods from the components?
You can either ignore them from the output file, or use the `@hidden` tag in the source code to omit a method or
property from being generated as docs. The recommended approach is to ignore them since adding the hidden tag will
create a lot of noise
### Can we detect Inputs and Outputs from Angular components?
Yes, check the decorators key-value on the json file for that particular component.
### Can we generate a json file for a specific component?
Yes, if we were to invoke `./node_modules/.bin/typedoc --options ./src/lib/typedoc.json --ignoreCompilerErrors ./src/lib/button`
We could theoretically generate a json file just for button, but we would ignore compiler errors because button does
not have a tsconfig or typings file local to its implementation.