Skip to content

Updated summaries#23989

Merged
jinujoseph merged 2 commits intodotnet:masterfrom
shaggygi:update-cref-wording
May 16, 2018
Merged

Updated summaries#23989
jinujoseph merged 2 commits intodotnet:masterfrom
shaggygi:update-cref-wording

Conversation

@shaggygi
Copy link
Copy Markdown
Contributor

@shaggygi shaggygi commented Jan 1, 2018

Updated wording in summaries.

@shaggygi shaggygi requested a review from a team as a code owner January 1, 2018 19:32

/// <summary>
/// Create a new instance of an <see cref="MSBuildProjectLoader"/>.
/// Create a new instance of a <see cref="MSBuildProjectLoader"/>.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Technically, 'an' is correct since MS is pronounced "em ess", and that leads with a vowel sound... 😄

(English is a terrible language.)

/// <summary>
/// A service which enables searching for packages matching certain criteria.
/// It works against an <see cref="Microsoft.CodeAnalysis.Elfie"/> database to find results.
/// It works against a <see cref="Microsoft.CodeAnalysis.Elfie"/> database to find results.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Curious on this case and others -- if this gets rendered as just "Elfie" in the final display of the comment, you'd want it 'an'....I'm not sure what is right though.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Yeah. this is tricky :) I know i picked 'an' here because in my mind i was saying "an Elfie database". But it really depends on final rendering.

@jcouv jcouv added Community The pull request was submitted by a contributor who is not a Microsoft employee. Area-Compilers labels Mar 31, 2018
@jcouv jcouv added this to the 15.8 milestone Mar 31, 2018
@jasonmalinowski
Copy link
Copy Markdown
Member

@shaggygi: we'll need to resolve the merge conflicts here before merging this. Do you mind if we resolve and push to your PR branch?

@shaggygi
Copy link
Copy Markdown
Contributor Author

@jasonmalinowski sure. Do whatever is needed. Does it require anything on my end?

@jasonmalinowski
Copy link
Copy Markdown
Member

@shaggygi: just that. GitHub lets me push to your branch in your repo (but just that branch) because of this PR; I just wanted to let you know before we do that it's happening.

@shaggygi shaggygi requested a review from a team as a code owner May 14, 2018 21:57
@jasonmalinowski
Copy link
Copy Markdown
Member

@jinujoseph Ask mode approval? Just changing some doc comment grammar.

@jinujoseph
Copy link
Copy Markdown
Contributor

Approved to merge for 15.8.Preview3

@jinujoseph
Copy link
Copy Markdown
Contributor

test windows_release_vs-integration_prtest

@jinujoseph jinujoseph merged commit 3c68ab4 into dotnet:master May 16, 2018
@shaggygi shaggygi deleted the update-cref-wording branch May 16, 2018 09:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Approved to merge Area-IDE Community The pull request was submitted by a contributor who is not a Microsoft employee. Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants