removed random instance
revised documentation