PowerShell / PowerShellGallery

219 stars 59 forks source link

Include Help text in PSGallery #249

Open simsrw73 opened 1 year ago

simsrw73 commented 1 year ago

Summary of the new feature / enhancement

It's very difficult to find and compare modules in many cases on PSGallery. One-line descriptions are often inadequate. There are cases where search leads to a module that is somewhat related to what I want without providing the exact feature that I want. And there is no way to know that from PSGallery without installing the module or chasing the project page down and hoping the info is there, otherwise navigating through the online source to read the help text.

It's much more difficult than it needs to be and having to install a bunch of modules to find the one that performs the required task is not ideal in many environments. The module/package community can often make or break a scripting language. This seems like it would be a simple improvement that could make drastic improvement: Extract the help text when modules are uploaded and link it on the module page.

Additionally, or as a lesser alternative: inline the project page (README.md) on the module page. This is an approach taken by other languages, eg crates or python package index.

If the Gallery were open source, others could help improve the site. And the many, many outdated issues in this tracker could be cleaned up. 😀

Proposed technical implementation details (optional)

No response