add docs for new feature
changelog entry for PR 173