holoviz / param

Param: Make your Python code clearer and more reliable by declaring Parameters
https://param.holoviz.org
BSD 3-Clause "New" or "Revised" License
410 stars 69 forks source link

Discussion about the intro video #934

Open maximlt opened 2 months ago

maximlt commented 2 months ago

Fixing https://github.com/holoviz/param/issues/932, I noticed that the link to download the Promo notebook on which is based the intro video was broken (https://tinyurl.com/parampromo). The notebook links to an image in docs/assets, link that is likely to be broken too.

Beyond these issues, the video, even if it's nice, is at this stage a bit outdated (no bind, rx, HTML repr, etc.). I also have to say that as someone who has looked at many websites of Python packages, I feel that having an intro video for a package like Param is unexpected (I don't think I would watch it, to be honest). I would instead expect code snippets and a bullet list of features, that help me to quickly grasp what the library offers. With links to sections of interest to dig further. See this for instance https://docs.pydantic.dev/latest/. I would by the way expect the same thing on the README. So my preference would be to replace the video in favor of that kind of content. What do others think about it? I'm not super happy suggesting that we get rid of something that probably needed a lot of work to create, at the same time, it's also difficult to maintain over time.

MarcSkovMadsen commented 2 months ago

Sounds good to me