https://github.com/dotnet/docs/issues/3455 The DotNet team is collecting feedback on this item as well.Nisse 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.