doc for property destructuring

[ArunS-tack]

closes #41181.

Don't mind the commit message, that's a typo.

[simeonschaub]

Could you move that section above the argument destructuring one? I think it could also fit a bit better with the flow of the Destructuring Assignment and Multiple Return Values section, so start with something like

Instead of destructuring based on iteration, the right side of assignments can also be destructured using property names. This follows the syntax for NamedTuples, and works by assigning to each variable on the left a property of the right side of the assignment with the same name using getproperty:
[simple example here]

I think that would read nicer in the manual than the News entry you copied here. I would then also move the parts about argument destructuring in functions to the dedicated Argument Destructuring section just below.

Also, please try to run the doctests you pasted here yourself, the first one looks incorrect and the linebreaks are also off.