changelog/API docs for #274