clarifications, fixes some links