updated gordon user guide

For Mahidhar and/or Bob's review