improvement doc, examples