readme complete
more doc strings