touch up docs to link to eachother