improved documentation on captured links