From 43b947057b87ea8a4f8ab8995dc842a7f9c654e4 Mon Sep 17 00:00:00 2001 From: Rick Anderson <3605364+Rick-Anderson@users.noreply.github.com> Date: Tue, 2 Jul 2024 10:16:09 -1000 Subject: [PATCH 1/2] Update dotnet-voice-tone.md --- Contribute/content/dotnet/dotnet-voice-tone.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Contribute/content/dotnet/dotnet-voice-tone.md b/Contribute/content/dotnet/dotnet-voice-tone.md index a22fd6cf..4f57ac6e 100644 --- a/Contribute/content/dotnet/dotnet-voice-tone.md +++ b/Contribute/content/dotnet/dotnet-voice-tone.md @@ -25,10 +25,13 @@ One might see the contrast between a conversational style and the style one find ## Write in second person The following paragraph uses second person. The one that follows it uses third person. Please write in second person. +Second person: You should configure the connection string in the `appsettings.json` file to ensure your app connects to your database. +Third person: The developer should configure the connection string in the `appsettings.json` file to ensure the app connects to the developers database. + ### Appropriate style -Write your articles as though you are speaking directly to the reader. Use second person often (as in these two sentences). 2nd person doesn't always mean using the word 'you'. Write directly to the reader. Write imperative sentences. Tell your reader what you want them to learn. +Write your articles as though you are speaking directly to the reader. Use second person often, as in these two sentences. 2nd person doesn't always mean using the word 'you'. Write directly to the reader. Write imperative sentences. Tell your reader what you want them to learn. ### Inappropriate style From ca7c29ab624a4fc44e4a2d3d5d66712e39ae2e35 Mon Sep 17 00:00:00 2001 From: Rick Anderson <3605364+Rick-Anderson@users.noreply.github.com> Date: Tue, 2 Jul 2024 14:43:46 -1000 Subject: [PATCH 2/2] Update Contribute/content/dotnet/dotnet-voice-tone.md Co-authored-by: Tom Dykstra --- Contribute/content/dotnet/dotnet-voice-tone.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Contribute/content/dotnet/dotnet-voice-tone.md b/Contribute/content/dotnet/dotnet-voice-tone.md index 4f57ac6e..4224fce3 100644 --- a/Contribute/content/dotnet/dotnet-voice-tone.md +++ b/Contribute/content/dotnet/dotnet-voice-tone.md @@ -26,7 +26,7 @@ One might see the contrast between a conversational style and the style one find The following paragraph uses second person. The one that follows it uses third person. Please write in second person. Second person: You should configure the connection string in the `appsettings.json` file to ensure your app connects to your database. -Third person: The developer should configure the connection string in the `appsettings.json` file to ensure the app connects to the developers database. +Third person: The developer should configure the connection string in the `appsettings.json` file to ensure the app connects to the developer's database. ### Appropriate style