doc to be reviewed and new directions to be added