Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

build(docs-infra): do not include license comment in first API doc #26050

Conversation

petebacondarwin
Copy link
Member

The default dgeni config is to concatenate leading comments in front of API items.

In the case that you have an API item that starts a file with no import statements,
the license comment at the top of the file was being added to the front of the
API item's comment. SInce the license comment includes the @license tag
and the API item's comment did not start with @description the content of
the API item's comment was being put inside the @license tag, and no
description was being extracted from the API item's comment.

This commit updates to a version of dgeni-packages that has a switch to turn off
this concatenation, and then also configures this switch.

Closes #26045

@petebacondarwin petebacondarwin added type: bug/fix action: review The PR is still awaiting reviews from at least one requested reviewer effort1: hours freq2: medium severity1: confusing target: patch This PR is targeted for the next patch release risk: low labels Sep 21, 2018
@petebacondarwin petebacondarwin added this to the Backlog milestone Sep 21, 2018
@mary-poppins
Copy link

You can preview d4bb829 at https://pr26050-d4bb829.ngbuilds.io/.

@petebacondarwin petebacondarwin added this to REVIEW in docs-infra Sep 21, 2018
@gkalpak
Copy link
Member

gkalpak commented Sep 21, 2018

LGTM except for the Travis failures 😁

@gkalpak gkalpak added action: cleanup The PR is in need of cleanup, either due to needing a rebase or in response to comments from reviews and removed action: review The PR is still awaiting reviews from at least one requested reviewer labels Sep 21, 2018
@petebacondarwin
Copy link
Member Author

Urgh!

The default dgeni config is to concatenate leading comments in front of API items.

In the case that you have an API item that starts a file with no import statements,
the license comment at the top of the file was being added to the front of the
API item's comment. SInce the license comment includes the `@license` tag
and the API item's comment did not start with `@description` the content of
the API item's comment was being put inside the `@license` tag, and no
description was being extracted from the API item's comment.

This commit updates to a version of dgeni-packages that has a switch to turn off
this concatenation, and then also configures this switch.

Closes angular#26045
@petebacondarwin
Copy link
Member Author

I put the config on the wrong dgeni package. Fixed now

@mary-poppins
Copy link

You can preview e44c73d at https://pr26050-e44c73d.ngbuilds.io/.

@gkalpak gkalpak added action: merge The PR is ready for merge by the caretaker and removed action: cleanup The PR is in need of cleanup, either due to needing a rebase or in response to comments from reviews labels Sep 21, 2018
@petebacondarwin petebacondarwin moved this from REVIEW to MERGE in docs-infra Sep 21, 2018
kara pushed a commit that referenced this pull request Sep 21, 2018
…26050)

The default dgeni config is to concatenate leading comments in front of API items.

In the case that you have an API item that starts a file with no import statements,
the license comment at the top of the file was being added to the front of the
API item's comment. SInce the license comment includes the `@license` tag
and the API item's comment did not start with `@description` the content of
the API item's comment was being put inside the `@license` tag, and no
description was being extracted from the API item's comment.

This commit updates to a version of dgeni-packages that has a switch to turn off
this concatenation, and then also configures this switch.

Closes #26045

PR Close #26050
@kara kara closed this in 9931bd7 Sep 21, 2018
@petebacondarwin petebacondarwin deleted the aio-fix-missing-descriptions branch September 21, 2018 18:41
FrederikSchlemmer pushed a commit to FrederikSchlemmer/angular that referenced this pull request Jan 3, 2019
…ngular#26050)

The default dgeni config is to concatenate leading comments in front of API items.

In the case that you have an API item that starts a file with no import statements,
the license comment at the top of the file was being added to the front of the
API item's comment. SInce the license comment includes the `@license` tag
and the API item's comment did not start with `@description` the content of
the API item's comment was being put inside the `@license` tag, and no
description was being extracted from the API item's comment.

This commit updates to a version of dgeni-packages that has a switch to turn off
this concatenation, and then also configures this switch.

Closes angular#26045

PR Close angular#26050
@angular-automatic-lock-bot
Copy link

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 14, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
action: merge The PR is ready for merge by the caretaker cla: yes effort1: hours freq2: medium risk: low target: patch This PR is targeted for the next patch release type: bug/fix
Projects
Development

Successfully merging this pull request may close these issues.

docs-infra: ChangeDetectorRef is missing description
4 participants