completed comments and instructions file for using vshift values from the database