update example with a DELETE endpoint. update generated docs accordingly and add the html version of it generated with pandoc