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.

Sign up for GitHub

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

Update dotnet-voice-tone.md #1019

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Update dotnet-voice-tone.md #1019

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
43b9470
Update dotnet-voice-tone.md
Rick-Anderson Jul 2, 2024
ca7c29a
Update Contribute/content/dotnet/dotnet-voice-tone.md
Rick-Anderson Jul 3, 2024
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
View file
Open in desktop
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