System.Diagnostics.Process docs do not refer to async StreamReader APIs

[ohadschn]

This issue is spread around a few sections, for example Process.StandardOutput:

The redirected StandardOutput stream can be read synchronously or asynchronously. Methods such as Read, ReadLine, and ReadToEnd perform synchronous read operations on the output stream of the process. These synchronous read operations do not complete until the associated Process writes to its StandardOutput stream, or closes the stream.

In contrast, BeginOutputReadLine starts asynchronous read operations on the StandardOutput stream. This method enables a designated event handler for the stream output and immediately returns to the caller, which can perform other work while the stream output is directed to the event handler.

The description makes it sound like sync = Read/ReadLine and async = BeginOutputReadLine/OutputDataReceived where in fact the recommended async approach would surely be the task-based System.IO.StreamReader.ReadXAsync (invoked on the supposedly "sync" StandardOutput).

[carlossanlop]

@adamsitnik @eiriktsarpalis as area owners for triaging

[eiriktsarpalis]

I presume this is because the documentation dates from the APM years before task-based async became available? I would probably just delete the entire section, since enumerating what is synchronous and what is asynchronous really concerns the contract of System.IO.StreamReader.