* @shinbunya kindly provided detailed edits to user guide. * this can be closed at the same time as the long standing #68