Updating links docs with failure modes