#21 - updated docs; added info abt references;