Repeated reactivity explanations

[opl-]

I noticed that both Reactivity in Depth (section Change Detection Caveats) and List Rendering (section Object Change Detection Caveats) mention the caveats of creating object properties and reactivity. They use slightly different, but fundamentally the same examples.

While this is certainly an important thing to mention, its repetition on both of those pages strikes me as odd and slightly confusing as a user coming back to the guides. I had a brief moment of uncertainty when I realized that it felt as though I've already read that section.

I'm not sure if this is significant enough to be worth correcting. Personally I feel like linking to the Reactivity in Depth page would be an easier to maintain and less confusing solution, though the importance of this explanation, as well as the name of the Reactivity in Depth guide in the section Internals suggesting it's an advanced topic and it's low position on the sidebar menu make me slightly hesitant to change it.

Thoughts?

[phanan]

I agree, linking (with a short introductive message perhaps) is a better option and more in-line with our documentation convention.

[rabbitwerks]

i also agree and would be willing to update the docs to reflect this.