added /doc, updated README, code cleaning