updated feature spec docs to match what we're actually doing