improve documentation

moved some of README into package header so it would appear in godoc