pub-dev icon indicating copy to clipboard operation
pub-dev copied to clipboard

Customize the Installing tab

Open vaind opened this issue 6 years ago • 5 comments

It would be useful to be able to add custom instructions to the auto-generated text in the "Installing" tab, or to replace the contents completely.

Goal: provide instructions on how to install pre-compiled native libraries (for a package making use of FFI)

vaind avatar Oct 30 '19 12:10 vaind

Yes, we've discussed rendering INSTALL.md as the installation tab. I think something like this would be useful.

jonasfj avatar Oct 31 '19 15:10 jonasfj

We also discussed install.md in https://github.com/dart-lang/pub-dev/issues/2125.

jonasfj avatar Nov 08 '19 16:11 jonasfj

As briefly discussed in https://github.com/dart-lang/pub-dev/issues/3008 another option is to remove the "installation" instructions completely.

Arguments for removal is that if installation instructions are important to your package, it's probably best to show them at the top of your README.md as users are unlikely to see them otherwise. We could probably look at analytics to see if anyone is opening the "installation" tab.

jonasfj avatar Nov 08 '19 16:11 jonasfj

Users of my package, flutter_native_splash, have contacted me with confusion because my readme tells them to add a in dev_dependencies (with is correct), but the installing tab tells them to add in dependencies (which is incorrect). Would be nice to get this fixed!

jonbhanson avatar May 21 '21 19:05 jonbhanson

Users of my package, flutter_native_splash, have contacted me with confusion because my readme tells them to add a in dev_dependencies (with is correct), but the installing tab tells them to add in dependencies (which is incorrect). Would be nice to get this fixed!

I think we should find a way to do: https://github.com/dart-lang/pub-dev/issues/6400 that would at least solve this specifc issue.

Maybe we still need a custom install tab on top of that.

sigurdm avatar Jan 09 '25 09:01 sigurdm