added docs; fixes #15 and fixes #17