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

docs-infra: render @see tags on class members #28069

Closed

Conversation

petebacondarwin
Copy link
Member

Related to #26812 (comment)

Previously `@see` tags were only rendered for top level class-like
docs. Now these tags are rendered for methods and properties too.
@petebacondarwin petebacondarwin added feature Issue that requests a new feature action: review The PR is still awaiting reviews from at least one requested reviewer effort1: hours freq1: low comp: docs-infra target: patch This PR is targeted for the next patch release risk: low labels Jan 11, 2019
@petebacondarwin petebacondarwin added this to the docs-infra-tooling milestone Jan 11, 2019
@petebacondarwin petebacondarwin requested review from a team as code owners January 11, 2019 11:20
@@ -198,7 +198,7 @@ export abstract class AbstractControl {
/**
* A control is `valid` when its `status` is `VALID`.
*
* @see `status`
* @see {@link AbstractControl.status}
Copy link
Member Author

Choose a reason for hiding this comment

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

The status code block can be resolved ambiguously to multiple docs so we have to make it more explicit. We could have just put

@see `AbstractControl.status`

But this would result in having the full Abstract.status text in the link. Doing it this way, we only get the name of the member in the link text.

@mary-poppins
Copy link

You can preview 9b30d4d at https://pr28069-9b30d4d.ngbuilds.io/.

Copy link
Contributor

@kara kara left a comment

Choose a reason for hiding this comment

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

LGTM

@kara kara added action: merge The PR is ready for merge by the caretaker and removed action: review The PR is still awaiting reviews from at least one requested reviewer labels Jan 11, 2019
@AndrewKushnir
Copy link
Contributor

Presubmit

AndrewKushnir pushed a commit that referenced this pull request Jan 11, 2019
AndrewKushnir pushed a commit that referenced this pull request Jan 11, 2019
Previously `@see` tags were only rendered for top level class-like
docs. Now these tags are rendered for methods and properties too.

PR Close #28069
AndrewKushnir pushed a commit that referenced this pull request Jan 11, 2019
kyliau pushed a commit to kyliau/angular that referenced this pull request Jan 11, 2019
Previously `@see` tags were only rendered for top level class-like
docs. Now these tags are rendered for methods and properties too.

PR Close angular#28069
kyliau pushed a commit to kyliau/angular that referenced this pull request Jan 11, 2019
@gkalpak gkalpak added this to REVIEW in docs-infra Jan 12, 2019
petebacondarwin added a commit to petebacondarwin/angular that referenced this pull request Jan 14, 2019
Previously `@see` tags were only rendered for top level class-like
docs. Now these tags are rendered for methods and properties too.

PR Close angular#28069
petebacondarwin added a commit to petebacondarwin/angular that referenced this pull request Jan 14, 2019
AndrewKushnir pushed a commit that referenced this pull request Jan 16, 2019
Previously `@see` tags were only rendered for top level class-like
docs. Now these tags are rendered for methods and properties too.

PR Close #28069
AndrewKushnir pushed a commit that referenced this pull request Jan 16, 2019
wKoza pushed a commit to wKoza/angular that referenced this pull request Jan 18, 2019
Previously `@see` tags were only rendered for top level class-like
docs. Now these tags are rendered for methods and properties too.

PR Close angular#28069
wKoza pushed a commit to wKoza/angular that referenced this pull request Jan 18, 2019
wKoza pushed a commit to wKoza/angular that referenced this pull request Jan 18, 2019
Previously `@see` tags were only rendered for top level class-like
docs. Now these tags are rendered for methods and properties too.

PR Close angular#28069
wKoza pushed a commit to wKoza/angular that referenced this pull request Jan 18, 2019
ngfelixl pushed a commit to ngfelixl/angular that referenced this pull request Jan 28, 2019
Previously `@see` tags were only rendered for top level class-like
docs. Now these tags are rendered for methods and properties too.

PR Close angular#28069
ngfelixl pushed a commit to ngfelixl/angular that referenced this pull request Jan 28, 2019
@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 feature Issue that requests a new feature freq1: low risk: low target: patch This PR is targeted for the next patch release
Projects
Development

Successfully merging this pull request may close these issues.

None yet

6 participants