Skip to content

docs: MatMenu api docs are not generated #16219

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

Conversation

devversion
Copy link
Member

Currently the MatMenu API docs are not generated because the MatMenu
class is no longer treated as directive/component because there is no
decorator w/ directive metadata.

In order to fix this in a flexible way, a new JSdoc tag has been introduced
that allows enforcing the public state of a symbol (with the possibility of
having a public symbol name). This allows us to actually expose the
real _MatMenu class w/ directive metadata in the API docs under the
MatMenu symbol name.

Fixes #16198

Currently the `MatMenu` API docs are not generated because the `MatMenu`
class is no longer treated as directive/component because there is no
decorator w/ directive metadata.

In order to fix this in a flexible way, a new JSdoc tag has been introduced
that allows enforcing the public state of a symbol (with the possibility of
having a public symbol name). This allows us to actually expose the
real `_MatMenu` class w/ directive metadata in the API docs under the
`MatMenu` symbol name.

Fixes angular#16198
@devversion devversion added pr: merge safe target: patch This PR is targeted for the next patch release labels Jun 6, 2019
@googlebot googlebot added the cla: yes PR author has agreed to Google's Contributor License Agreement label Jun 6, 2019
@devversion
Copy link
Member Author

devversion commented Jun 6, 2019

@jelbourn I wasn't too sure what we should do with the _MatMenu export. Should we still somehow list in the API docs? Right now only _MatMenu (as MatMenu) shows up in the docs (which sounds reasonable to me)

Copy link
Member

@jelbourn jelbourn left a comment

Choose a reason for hiding this comment

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

LGTM

@jelbourn jelbourn added pr: lgtm action: merge The PR is ready for merge by the caretaker labels Jun 7, 2019
@josephperrott josephperrott merged commit 98b880b into angular:master Jun 7, 2019
josephperrott pushed a commit that referenced this pull request Jun 10, 2019
Currently the `MatMenu` API docs are not generated because the `MatMenu`
class is no longer treated as directive/component because there is no
decorator w/ directive metadata.

In order to fix this in a flexible way, a new JSdoc tag has been introduced
that allows enforcing the public state of a symbol (with the possibility of
having a public symbol name). This allows us to actually expose the
real `_MatMenu` class w/ directive metadata in the API docs under the
`MatMenu` symbol name.

Fixes #16198
RudolfFrederiksen pushed a commit to RudolfFrederiksen/material2 that referenced this pull request Jun 21, 2019
Currently the `MatMenu` API docs are not generated because the `MatMenu`
class is no longer treated as directive/component because there is no
decorator w/ directive metadata.

In order to fix this in a flexible way, a new JSdoc tag has been introduced
that allows enforcing the public state of a symbol (with the possibility of
having a public symbol name). This allows us to actually expose the
real `_MatMenu` class w/ directive metadata in the API docs under the
`MatMenu` symbol name.

Fixes angular#16198
@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 10, 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 PR author has agreed to Google's Contributor License Agreement target: patch This PR is targeted for the next patch release
Projects
None yet
Development

Successfully merging this pull request may close these issues.

MatMenu API docs are missing from the docs site
4 participants