add notes with links to documentation