search

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
427 stars 73 forks source link

Updated reactive docs #841

Closed jbednar closed 1 year ago

jbednar commented 1 year ago

I think this will take several iterations, but I've tried to tease out a better motivating introductory section without making too many changes. @philippjfr , please review and see if it's going in a direction you're happy with; feel free to close if not.

I suspect that it's still trying to be too ambitious, and that we shouldn't immediately dive in trying to change the dataframe itself, because that's an advanced topic using bind, while if we simply make the dataframe and some values reactive, I think the user will be able to see how it works much better. If I get a chance I'll try that out, but wanted you to have this before I went to bed in case you work on it tomorrow.

I also think the example still isn't that great without widgets. I do like what it does for the loop I put in there now, which substitutes for having a slider; I think there's something we can do with that. E.g. maybe some sort of animation?

Plus the material after the "Why?" section is still starting with Parameters, while I think it would be better to focus on what a reactive expression is and how it behaves, and then get into Parameters only as one way of getting such an expression, as well as an implementation detail behind them. Anyway, not urgent, just handing this over in case it's useful!

philippjfr commented 1 year ago

Thanks, I honestly just wanted to get something in before the RC release. This may well still be too ambitious but it's definitely an improvement.