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
docs-infra: render @see
tags on class members
#28069
Conversation
Previously `@see` tags were only rendered for top level class-like docs. Now these tags are rendered for methods and properties too.
@@ -198,7 +198,7 @@ export abstract class AbstractControl { | |||
/** | |||
* A control is `valid` when its `status` is `VALID`. | |||
* | |||
* @see `status` | |||
* @see {@link AbstractControl.status} |
There was a problem hiding this comment.
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.
You can preview 9b30d4d at https://pr28069-9b30d4d.ngbuilds.io/. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
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
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
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
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
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
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
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
This issue has been automatically locked due to inactivity. Read more about our automatic conversation locking policy. This action has been performed automatically by a bot. |
Related to #26812 (comment)