System.IO.Stream.Position remarks section has puzzling sentence

[elgonzo]

The Remarks section for the System.IO.Stream.Position property (https://learn.microsoft.com/en-us/dotnet/api/system.io.stream.position?view=net-7.0) features this seemingly puzzling sentence:

The Position property does not keep track of the number of bytes from the stream that have been consumed, skipped, or both.

It is entirely unclear how this would be relevant/significant information in understanding that the Position property indicates a ..uh.. position. Being a bit of a pessimist, i fear that this sentence might create confusion for beginners reading this by inadvertently implying that reading from (consuming) and seeking over (skipping) a stream won't have a bearing on the stream's position.

Tagging subscribers to this area: @dotnet/area-system-io
See info in area-owners.md if you want to be subscribed.

Issue Details

---

The Remarks section for the System.IO.Stream.Position property (https://learn.microsoft.com/en-us/dotnet/api/system.io.stream.position?view=net-7.0) features this seemingly puzzling sentence:

The Position property does not keep track of the number of bytes from the stream that have been consumed, skipped, or both.

It is entirely unclear how this would be relevant/significant information in understanding that the Position property indicates a ..uh.. position. Being a bit of a pessimist, i fear that this sentence might create confusion for beginners reading this by inadvertently implying that reading from (consuming) and seeking over (skipping) a stream won't have a bearing on the stream's position.

Author:	elgonzo
Assignees:	-
Labels:	untriaged, Pri3, area-System.IO
Milestone:	-

[adamsitnik]

Hi @elgonzo

I agree that it's confusing. Should we just remove it?

[elgonzo]

Personally, i feel this sentence should be removed.

[adamsitnik]

@elgonzo would you be interested in sending a PR?