Skip to content
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] Synchronize with MicrosoftDocs/xamarin-docs (#6886) #7208

Merged
merged 1 commit into from
Jul 27, 2022

Conversation

jonpryor
Copy link
Member

Context: MicrosoftDocs/xamarin-docs@fa13cf9

After synchronizing xamarin/xamarin-android docs with
MicrosoftDocs/xamarin-docs, now we synchronize the other way, to
preserve documentation edits.

Note that many of the changes here are to "appease" Acrolinx,
"rewording" the documentation to achieve an Acrolinx score of 80.
Of note:

  • "additional" is not liked.
  • "which" should always follow a comma; use "that" instead.
  • "this" is always potentially ambiguous, and a less ambiguous
    phrase should be used instead.
  • Informal writing is preferred (?!), along with greater use of
    contractions.
  • The phrase "Defaults to" is bad.

Context: MicrosoftDocs/xamarin-docs@fa13cf9

After synchronizing xamarin/xamarin-android docs with
MicrosoftDocs/xamarin-docs, now we synchronize the other way, to
preserve documentation edits.

Note that many of the changes here are to "appease" [Acrolinx][0],
"rewording" the documentation to achieve an Acrolinx score of 80.
Of note:

  * "additional" is not liked.
  * "which" should always follow a comma; use "that" instead.
  * "this" is always potentially ambiguous, and a less ambiguous
    phrase should be used instead.
  * *Informal* writing is preferred (?!), along with greater use of
    contractions.
  * The phrase "Defaults to" is bad.

[0]: https://www.acrolinx.com/
@jonpryor jonpryor merged commit 79be326 into dotnet:main Jul 27, 2022
grendello added a commit to grendello/xamarin-android that referenced this pull request Aug 1, 2022
* main:
  LEGO: Merge pull request 7221
  LEGO: Merge pull request 7219
  [Xamarin.Android.Build.Tasks] use `ToJniName(type, cache)` (dotnet#7211)
  [docs] Synchronize with MicrosoftDocs/xamarin-docs (dotnet#7208)
  [Mono.Android] Remove System.Linq usage (dotnet#7210)
  Bump to Android NDK r25 (dotnet#6764)
  Bump to mono/opentk@daa9b2d5 (dotnet#7192)
  [Mono.Android] Optional NTLMv2 support in AndroidMessageHandler (dotnet#6999)
  Bump to dotnet/installer@53587f9 7.0.100-rc.1.22374.1 (dotnet#7198)
grendello added a commit to grendello/xamarin-android that referenced this pull request Aug 1, 2022
* mm-codegen:
  LEGO: Merge pull request 7221
  LEGO: Merge pull request 7219
  [Xamarin.Android.Build.Tasks] use `ToJniName(type, cache)` (dotnet#7211)
  [docs] Synchronize with MicrosoftDocs/xamarin-docs (dotnet#7208)
  [Mono.Android] Remove System.Linq usage (dotnet#7210)
  Bump to Android NDK r25 (dotnet#6764)
  Bump to mono/opentk@daa9b2d5 (dotnet#7192)
  [Mono.Android] Optional NTLMv2 support in AndroidMessageHandler (dotnet#6999)
  Bump to dotnet/installer@53587f9 7.0.100-rc.1.22374.1 (dotnet#7198)
@github-actions github-actions bot locked and limited conversation to collaborators Jan 24, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants