added more documentation. reduced number of perms in examples