do some more clarifications before official 1.0.1 release