fleshing out the details
docs
fix build