update docs with usage example and format changelog