File based apps document has incorrect shebang recommendation

[jhudsoncedaron]

Describe the issue or suggestion

This document: https://learn.microsoft.com/en-us/dotnet/core/sdk/file-based-apps

Reads: #!/usr/bin/env dotnet

Should read #!/usr/bin/env -S dotnet --

I originally thought it was busted in the code due to not finding a working invocation, but no, the one thing I didn't think of works. You can see some of the things I tried and wasted time on here: dotnet/sdk#53810 (comment)

[jjonescz]

As far as I understand, env -S might not be supported by all systems. Although it would be a slight breaking change, I think we could change dotnet file.cs ...args... to work same as dotnet run --file file.cs -- ...args... and then you could continue using just the simple #!/usr/bin/env dotnet.

[jhudsoncedaron]

@jjonescz : You're right, it is not. But both Linux and Mac OSX have env -S now. (Mac OSX is late to the party; older versions don't have it.)