more cleanup.
clarifications, fixes some links