fixed two links and added a paragraph

Issue #983