add :edit to the release notes, and improve the docs a bit