https://github.com/dotnet/docs/issues/3455 The DotNet team is collecting feedback on this item as well.
An error occurred while saving the commentNisse commented
Just start by documenting PowerShell. That will go a long way.
And by documentation I mean real documentation with data types, exceptions return values (with data type). There should also be documentations of all prerequisites, assumptions and anything else that might affect how the cmdlet work.