fixed shuffling bug added dokucmentation