improved commments and usage examples