Skip to content

build(aio): correctly render decorator docs#14328

Merged
IgorMinar merged 1 commit into
angular:masterfrom
petebacondarwin:doc-gen-fix-decorator-docs
Feb 7, 2017
Merged

build(aio): correctly render decorator docs#14328
IgorMinar merged 1 commit into
angular:masterfrom
petebacondarwin:doc-gen-fix-decorator-docs

Conversation

@petebacondarwin

Copy link
Copy Markdown
Contributor

This commit updates the doc-gen to account
for the changes to the codebase for decorators.

There are actually three kinds of calls that create decorators:

  • makeDecorator
  • makePropDecorator
  • makeParamDecorator

Also, the actual documentation for each
decorator is split between two exported symbols:

  • interface [DecoratorName] contains the metadata fields
  • interface [DecoratorName]Decorator` contains a
    "call member" which holds the general description of the decorator.

This processor now identifies all three decorator types, and pulls the
description of the callMember onto the main decorator doc description.

(There are some outstanding interfaces in the angular/angular project that
need to be re-exported from /angular/modules/@angular/core/src/metadata.ts
to ensure that the doc-gen is able to access them.)

Closes angular/angular.io#2349

Please check if the PR fulfills these requirements

What kind of change does this PR introduce? (check one with "x")

[ ] Bugfix
[ ] Feature
[ ] Code style update (formatting, local variables)
[ ] Refactoring (no functional changes, no api changes)
[ ] Build related changes
[ ] CI related changes
[ ] Other... Please describe:

What is the current behavior? (You can also link to an open issue here)

What is the new behavior?

Does this PR introduce a breaking change? (check one with "x")

[ ] Yes
[ ] No

If this PR contains a breaking change, please describe the impact and migration path for existing applications: ...

Other information:

This commit updates the doc-gen to account
for the changes to the codebase for decorators.

There are actually three kinds of calls that create decorators:

* makeDecorator
* makePropDecorator
* makeParamDecorator

Also, the actual documentation for each
decorator is split between two exported symbols:

* `interface [DecoratorName]` contains the metadata fields
* interface [DecoratorName]Decorator` contains a
  "call member" which holds the general description of the decorator.

This processor now identifies all three decorator types, and pulls the
description of the callMember onto the main decorator doc description.

(There are some outstanding interfaces in the angular/angular project that
need to be re-exported from `/angular/modules/@angular/core/src/metadata.ts`
to ensure that the doc-gen is able to access them.)

Closes angular/angular.io#2349
@IgorMinar

Copy link
Copy Markdown
Contributor

@petebacondarwin CI failing. I restarted the aio job to confirm it's not a flake.

@IgorMinar IgorMinar self-requested a review February 7, 2017 06:30
@petebacondarwin

Copy link
Copy Markdown
Contributor Author

Seems that it was a flake?

@IgorMinar IgorMinar left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm. I'll rewrite the commit message to categorize this as a fix rather than build. for aio, build in my view of the world is just build infrastructure related changes (like our changes to package.json, pre-rendering setup, etc)

@IgorMinar IgorMinar merged commit d4ffa47 into angular:master Feb 7, 2017
@petebacondarwin

Copy link
Copy Markdown
Contributor Author

OK thanks @IgorMinar

@petebacondarwin petebacondarwin deleted the doc-gen-fix-decorator-docs branch March 21, 2017 12:00
asnowwolf pushed a commit to asnowwolf/angular that referenced this pull request Aug 11, 2017
This commit updates the doc-gen to account
for the changes to the codebase for decorators.

There are actually three kinds of calls that create decorators:

* makeDecorator
* makePropDecorator
* makeParamDecorator

Also, the actual documentation for each
decorator is split between two exported symbols:

* `interface [DecoratorName]` contains the metadata fields
* interface [DecoratorName]Decorator` contains a
  "call member" which holds the general description of the decorator.

This processor now identifies all three decorator types, and pulls the
description of the callMember onto the main decorator doc description.

(There are some outstanding interfaces in the angular/angular project that
need to be re-exported from `/angular/modules/@angular/core/src/metadata.ts`
to ensure that the doc-gen is able to access them.)

Closes angular/angular.io#2349
juleskremer pushed a commit to juleskremer/angular that referenced this pull request Aug 28, 2017
This commit updates the doc-gen to account
for the changes to the codebase for decorators.

There are actually three kinds of calls that create decorators:

* makeDecorator
* makePropDecorator
* makeParamDecorator

Also, the actual documentation for each
decorator is split between two exported symbols:

* `interface [DecoratorName]` contains the metadata fields
* interface [DecoratorName]Decorator` contains a
  "call member" which holds the general description of the decorator.

This processor now identifies all three decorator types, and pulls the
description of the callMember onto the main decorator doc description.

(There are some outstanding interfaces in the angular/angular project that
need to be re-exported from `/angular/modules/@angular/core/src/metadata.ts`
to ensure that the doc-gen is able to access them.)

Closes angular/angular.io#2349
@angular-automatic-lock-bot

Copy link
Copy Markdown

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

This action has been performed automatically by a bot.

@angular-automatic-lock-bot angular-automatic-lock-bot Bot locked and limited conversation to collaborators Sep 11, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants