Improve Link Object Examples

Ports from 3.1 the Link Object example description improvements.
The related section tweaks were included in the larger 3.2
section reorganization.