read me edits, option placeholders
minimal updates to get working (old api)