Improve HoloViews reference guide

[MarcSkovMadsen]

Via https://github.com/holoviz/panel/issues/5628 its clear that the HoloViews reference notebook does not clearly explain how things are expected to work. After working with it I can also see that its not updated to reflect how the HoloViews pane works today. I also believe some of the things that are explained does not work due to bugs.

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 71.48%. Comparing base (e8ad8db) to head (2e49cf6). Report is 3 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #6065      +/-   ##
==========================================
- Coverage   71.52%   71.48%   -0.04%     
==========================================
  Files         310      312       +2     
  Lines       45996    46050      +54     
==========================================
+ Hits        32898    32921      +23     
- Misses      13098    13129      +31     

Flag	Coverage Δ
unitexamples-tests	71.48% <100.00%> (-0.04%)	:arrow_down:

Flags with carried forward coverage won't be shown. Click here to find out more.

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[MarcSkovMadsen]

There are so many issues here. I need an expert on HoloViews (the framework) and HoloViews (the pane) to go through my comments and give me some feedback on who should do what.

I don't plan to do more before I get that feedback.

[MarcSkovMadsen]

Maybe I forgot to "release this". I've done that now. It is ready for review.

[philippjfr]

I'll retarget for 1.4.0 because I don't want to hold up the release much more, but if I do get a chance before tomorrow I will backport it.