more details, less links to PRs. added notes for developers.