Fleshing out specs
updated README to reflect current status
Documentation