documented edit with example