Skip to content

Commit

Permalink
Update dotnet-voice-tone.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Rick-Anderson authored Jul 2, 2024
1 parent a8e138b commit 43b9470
Showing 1 changed file with 4 additions and 1 deletion.
5 changes: 4 additions & 1 deletion Contribute/content/dotnet/dotnet-voice-tone.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down

0 comments on commit 43b9470

Please sign in to comment.