Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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 developer's 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