Skip to content

docs: grammar test-harness #18293

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 4 commits into from
Jan 29, 2020
Merged

docs: grammar test-harness #18293

merged 4 commits into from
Jan 29, 2020

Conversation

timdeschryver
Copy link
Contributor

No description provided.

@googlebot googlebot added the cla: yes PR author has agreed to Google's Contributor License Agreement label Jan 26, 2020
@devversion devversion added the docs This issue is related to documentation label Jan 27, 2020
There are times when a component harness might need to access elements outside of it's corresponding
component's host element. A good example of this is components that use the
There are times when a component harness might need to access elements outside of its corresponding
component's host element. A good example of this are the components that use the
Copy link
Contributor

Choose a reason for hiding this comment

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

This still sounds a bit awkward because "A good example" is singular and "the components" is plural. Maybe change the beginning of the sentence to "Some good examples of this are"

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This does indeed read better, I changed it.

@mmalerba mmalerba added pr: lgtm action: merge The PR is ready for merge by the caretaker target: patch This PR is targeted for the next patch release labels Jan 27, 2020
@@ -1,4 +1,4 @@
`@angular/cdk/testing` provides infrastructure to help with testing Angular components.
`@angular/cdk/testing` provides an infrastructure to help with testing Angular components.
Copy link
Member

@jelbourn jelbourn Jan 29, 2020

Choose a reason for hiding this comment

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

I think this read better without the "an"

@@ -385,7 +385,7 @@ authors to write easily understandable code, e.g.
for the particular subclass.

Harnesses that need to add additional options should extend the `BaseHarnessFilters` interface and
additional optional properties as needed. `HarnessPredicate` provides several convenience methods
additional optional properties as needed. `HarnessPredicate` provides several convenient methods
Copy link
Member

Choose a reason for hiding this comment

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

"Convenience method" is actually a generally well-known concept: https://en.wiktionary.org/wiki/convenience_method

Copy link
Contributor Author

@timdeschryver timdeschryver Jan 29, 2020

Choose a reason for hiding this comment

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

Thanks for the review, I addressed the feedback

There are times when a component harness might need to access elements outside of it's corresponding
component's host element. A good example of this is components that use the
There are times when a component harness might need to access elements outside of its corresponding
component's host element. Some good examples of this are the components that use the
Copy link
Member

Choose a reason for hiding this comment

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

I would do
"Components that use CDK overlay serve as examples of this"

Avoids passive voice

@jelbourn jelbourn removed the action: merge The PR is ready for merge by the caretaker label Jan 29, 2020
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 the action: merge The PR is ready for merge by the caretaker label Jan 29, 2020
@jelbourn jelbourn merged commit dfb3e05 into angular:master Jan 29, 2020
jelbourn pushed a commit that referenced this pull request Jan 29, 2020
yifange pushed a commit to yifange/components that referenced this pull request Jan 30, 2020
@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 Feb 29, 2020
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 docs This issue is related to documentation target: patch This PR is targeted for the next patch release
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants