docs upd, closes #269