docs: improve closure variable inheritance examples

[joshtrichards]

• Additional comments
• Clarify existing comments
• Format comments consistently
• Modernize example output
• More distinct return value example

[kamil-tekiela]

I think this are too many comments now. The output is already shown below the example. If it's not obvious which line is from which call then maybe the example should be split into multiple examples.