Commit Graph

149 Commits

Author SHA1 Message Date
Ward Bell dbc3982aae docs(QuickStart): rewritten for 52 and latest recommendations
closes #472
2015-12-12 09:27:13 -08:00
Peter Bacon Darwin 05a272a116 refact(docs-app): move filtered API list into a directive
Each API index page now displays data from an `api-list.json` file found
locally to that page. This lets us have different API lists for TS, JS
and Dart.
2015-12-10 21:35:02 -08:00
Ward Bell 72e6a79126 chore(plunker-builder): better <base href> matching
closes #470
2015-12-10 11:52:25 -08:00
Ward Bell 70e29080f2 chore(devguide-tooling): update package.json/tsconfig/plunkerblder for alpha.51
closes #468
2015-12-10 10:31:46 -08:00
Jay Traband acb2dab91e chore(devguide-tooling): node_modules symlinks caused globbing problems for harp
closes #466
2015-12-10 01:16:36 -08:00
Naomi Black f7b6d83422 docs(dgeni): add in missing barrel files
closes #465
2015-12-09 14:49:35 -08:00
Peter Bacon Darwin 326e1f7395 chore(doc-gen): upgrade to use TypeScript 1.7.3 2015-12-09 12:18:33 +00:00
Peter Bacon Darwin 46735ad925 chore(doc-gen): fix target-package tests 2015-12-09 11:51:52 +00:00
Peter Bacon Darwin 3ede7bfea9 chore(doc-gen): new syntax for cheatsheet items 2015-12-08 17:37:19 -08:00
Peter Bacon Darwin 8459a4dd5c chore(doc-gen): allow dart cheatsheet to be generated 2015-12-08 17:31:53 -08:00
Jay Traband 0018e75d01 chore(devguide-tooling): node_modules symlink support for _examples and subdirs
closes #450.  READ COMMENTS IN PR450 FOR INSTRUCTIONS ON USAGE
We'll put these instructions some place better soon.

Also replace globule with globby ( perf issues) and explicitly exclude node_modules where possible.
Updated _examples/package.json for latest 3rd party libs (e.g. alpha.48) and
updated template-syntax/ts/package.json to be a prototypical example
2015-12-08 14:27:39 -08:00
Henry Wong fb2b979928 chore(docs-shredder): fixed misspelled word, 'overriden'
closes #435

'overriden' should be 'overridden'

http://dictionary.reference.com/browse/overridden
2015-12-02 19:03:58 -08:00
Peter Bacon Darwin af105bb354 chore(doc-gen): remove unwanted console.log 2015-12-02 11:53:50 +00:00
Peter Bacon Darwin 3759d6e6db WIP: fix up path issues 2015-12-01 20:43:20 -08:00
Peter Bacon Darwin eb37614d68 chore(doc-gen): update modules to include API docs
The public exported modules have been reorganized
2015-12-01 20:43:20 -08:00
Ward Bell 037a51505c chore(plunker): update to use alpha.47
closes #432
2015-12-01 14:42:14 -08:00
Jay Traband b06f2dcec6 (fix) plunker generation fixes
closes #424
plnkr - change plnkr.config -> plnkr.json and change output paths and names
update jade plunkers to new 'resources/live-examples' path + minor cleanup
update gulpfile to run build-plunkers as part of build-docs.
2015-11-30 21:00:02 -08:00
Ward Bell 758821c775 (docs) plunkers for template-syntax & pipes
closes #410
2015-11-25 17:54:28 -08:00
Jay Traband 4bbd9784ef dev-tooling: add plunker generation from _examples
closes #408, Dev Tooling 15
2015-11-25 12:23:14 -08:00
Peter Bacon Darwin 7e3e77778d api-builder: fix indentation on "Not Yet Documented" message 2015-11-17 10:36:09 +00:00
Peter Bacon Darwin bb170824ea api-builder: fix indentation on "Not Yet Documented" message 2015-11-17 10:05:03 +00:00
Naomi Black c304aedb04 Revert "api-builder: add breadcrumbs links"
This reverts commit 10b87e8017.
2015-11-16 23:10:18 -08:00
Peter Bacon Darwin 217c690781 api-builder: fix type-alias template so it doesn't break jade
The previous template was HTML rather than Jade and code blocks in the
content caused the Jade processing to crash.

See https://github.com/angular/angular/issues/4480
2015-11-15 21:36:20 +00:00
Peter Bacon Darwin 10b87e8017 api-builder: add breadcrumbs links 2015-11-13 16:39:21 +00:00
Peter Bacon Darwin 244e5673ab api-builder: filter out member docs
Since we are not rendering these independently of their containers
2015-11-13 16:39:21 +00:00
Peter Bacon Darwin 954a3827b7 api-builder: add simplified name to module docs 2015-11-13 16:39:21 +00:00
Peter Bacon Darwin 888f9ff8d8 api-builder: move templates into angular.io package 2015-11-13 16:39:21 +00:00
Peter Bacon Darwin a98085e7eb api-builder: allow descriptions to be empty via the `@noDescription` tag
If a document description is empty then it is marked with the `notYetDocumented`
property. This change allows developers to tag a code item (export, member, etc)
as explicitly not needing a description.
2015-11-13 16:39:21 +00:00
Peter Bacon Darwin 21feaf499f api-builder: deduce the type of a symbol from its initializer 2015-11-13 16:39:21 +00:00
Peter Bacon Darwin 229557dcb2 api-builder: move the `constructor` into its own section 2015-11-13 16:39:21 +00:00
Peter Bacon Darwin ec4d7b82a2 api-builder: don't show constructor if it is marked as `@internal` 2015-11-13 16:39:21 +00:00
Peter Bacon Darwin f84534a9e2 api-builder: include `exportAs` info in directive docs 2015-11-13 16:39:20 +00:00
Peter Bacon Darwin dbc95b75af api-builder: improve "not yet documented" handling
* All export members are now tagged if they have no documentation.
* All exports are tagged if they and their members have no documentation.
* The templates for these docs display the words "Not Yet Documented" if they are tagged.
* The build creates a warning for each export that is not documented
* The build generates a new file, `public/docs/ts/latest/api/overview-dump.html`, which
lists all the modules, exports and members highlighting those that are not documented.
2015-11-13 16:39:20 +00:00
Peter Bacon Darwin 489ffc9f97 api-builder: remove annotation block from directive docs 2015-11-13 16:38:58 +00:00
Peter Bacon Darwin 7239b52984 api-builder: remove unnecessary outputFolder config setting from angular.io-package
This is set in the gulpfile now
2015-11-13 16:38:58 +00:00
Peter Bacon Darwin ed3a4965e5 api-building: add `@syntax` tag to docs-package 2015-11-13 16:38:58 +00:00
Peter Bacon Darwin e86fde8dc9 chore(jade): upgrade to use `marked` filter
The `Transformers.markdown` (`:markdown`) filter is deprecated. This commit updates
the entire docs project to use the `jstransformer-marked` (`:marked') filter.
2015-11-10 18:37:53 +00:00
Peter Bacon Darwin 0f61ea288f api-builder: fix jade whitespace issues in the API templates 2015-11-10 18:37:20 +00:00
Peter Bacon Darwin bc7a17c4f6 api-builder: remove unwanted whitespace from directive template 2015-11-10 11:37:06 +00:00
Peter Bacon Darwin fc617d5a67 api-builder: fix incorrect jasmine matcher in target package tests 2015-11-10 11:37:06 +00:00
Peter Bacon Darwin 93c187de2a api-builder: trim blank lines from the end of a text block too 2015-11-10 11:37:06 +00:00
Peter Bacon Darwin 66a7edd8cb api-builder: add cheatsheet-package to generate cheatsheet data
Closes #348
2015-11-10 11:37:05 +00:00
Peter Bacon Darwin b68ef96472 api-builder: add target package 2015-11-07 09:30:55 +00:00
Peter Bacon Darwin bc8a319f61 api-builder: move ngdoc stuff out from doc-package and into content package 2015-11-06 12:51:25 +00:00
Peter Bacon Darwin d08ebf4b9a api-builder: refactor app-data doc to use generic pathTemplates 2015-11-04 16:21:11 +00:00
Peter Bacon Darwin bdc647462e angular.io-package: fix up test to match new functionality 2015-11-04 11:20:47 +00:00
Peter Bacon Darwin 83fbe75980 refact(api-builder): move into `tools` folder 2015-11-04 11:20:46 +00:00
Peter Bacon Darwin ce298009e6 refact(doc-shredder): move into `tools` folder 2015-11-04 10:47:05 +00:00
Peter Bacon Darwin a06b98ba75 refact(example-zipper): move into `tools` folder 2015-11-04 10:00:12 +00:00