dotnet / dotnet/dotnet-api-docs

Some things are inconsistant.

Open
#1,712 0 comments 0 reactions 0 assignees View on GitHub
area-System.Threading.Tasks dotnet-api/prod Pri2 untriaged
Dominant language
C#
Stars
949
Forks
1.7k
Avg merge
3d 27m
Merged PRs (30d)
49

Description

I think that these lines are inconsistant.

[The Task<TResult> class represents a single operation that returns a value and that usually executes asynchronously.....]
And
[Because the work performed by a Task<TResult>.....]

The first line says: Task <TResult> REPRESENTS a single operation, while the second line says: Task<TResult> PERFORMS a work.

Represent and performs are completely different actions. These line may make readers confused if task really PERFORM a work, or it just REPRESENTS a work.

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: 706c8cbd-30aa-fa63-f4fa-ac5a2ec68f17
* Version Independent ID: d4242290-60c1-11c1-3e08-8390fd3d4c35
* Content: [Task<TResult> Class (System.Threading.Tasks)](https://docs.microsoft.com/en-us/dotnet/api/system.threading.tasks.task-1?view=netframework-4.7.2)
* Content Source: [xml/System.Threading.Tasks/Task`1.xml](https://github.com/dotnet/dotnet-api-docs/blob/master/xml/System.Threading.Tasks/Task`1.xml)
* Product: **dotnet-api**
* GitHub Login: @rpetrusha
* Microsoft Alias: **ronpet**

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.