Skip to content

docs: sort class properties and methods #6893

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

Merged
merged 2 commits into from
Sep 8, 2017

Conversation

willshowell
Copy link
Contributor

  • Properties are sorted in the order of [Inputs, Outputs, neither]. Secondary sorting done alphabetically.
  • Methods are sorted alphabetically.
  • All deprecated members are sorted to the end.

On some components (ahem, select), it's really hard to parse the API's list of properties and methods. This sorts them into a, hopefully, logical order.

- Properties are sorted in the order of [Inputs, Outputs, neither]. Secondary sorting done alphabetically.
- Methods are sorted alphabetically.
- All deprecated members are sorted to the end.
@googlebot googlebot added the cla: yes PR author has agreed to Google's Contributor License Agreement label Sep 6, 2017
/** Sorts methods by deprecated status and name. */
function sortMethods(docA, docB) {
const deprecatedSort = sortByDeprecated(docA, docB);
if (!!deprecatedSort) {
Copy link
Member

Choose a reason for hiding this comment

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

Don't need !! in a condition

}

/** Sorts properties by deprecated status, decorator, and name. */
function sortProperties(docA, docB) {
Copy link
Member

Choose a reason for hiding this comment

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

Could you use the same function for properties and methods? All the checks for input/output should just return false for methods.

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 Sep 7, 2017
@tinayuangao tinayuangao merged commit 9f2fd47 into angular:master Sep 8, 2017
@willshowell willshowell deleted the docs/sort-class-members branch October 4, 2017 15:22
@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 7, 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
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants