Document how methods that update rx value in-place is expected to work.

[MarcSkovMadsen]

In https://discourse.holoviz.org/t/changes-to-a-param-rx-variable-do-not-trigger-ui-redraws-and-dont-notify-watchers-consistently/8475 Lennart sets a rx value to the empty list. Then he uses the .append method on the reactive object.

The UI actually updates - but only every second time - when the .append function is run. I don't know why.

But I do believe users cannot expect in-place methods to trigger reactive expressions. There is no documentation of this.

It should probably be explained in or close to the limitations section.

[holovizbot]

This issue has been mentioned on HoloViz Discourse. There might be relevant details there:

https://discourse.holoviz.org/t/changes-to-a-param-rx-variable-do-not-trigger-ui-redraws-and-dont-notify-watchers-consistently/8475/2