add doc for linking in with a list