Lots of Documentation added and some Refactoring and a bugfix

Squashed commit of the following:

commit f2f2f6358d8806c215ad0b9c55fa6d842ea5f3c9
Author: Caskman <eric.cascketta@gmail.com>
Date:   Mon May 6 14:23:09 2013 -0700

    refactored CritterContext

commit c50882c6400fa5953b4ee3e95318e2d6383222f0
Author: Caskman <eric.cascketta@gmail.com>
Date:   Mon May 6 14:21:17 2013 -0700

    more documentation added and dead critter hits bug fixed

commit 3fbc1869bf6678dc743f842de6a7196db8e072d8
Author: Caskman <eric.cascketta@gmail.com>
Date:   Mon May 6 13:58:15 2013 -0700

    more refactoring and documentation

commit d18d96b53ba96312ffda280a446bd626a6569277
Author: Caskman <eric.cascketta@gmail.com>
Date:   Mon May 6 13:46:03 2013 -0700

    refactoring and documentation

commit f440332904271385515b8dad3bc7942bb2fe468f
Author: Caskman <eric.cascketta@gmail.com>
Date:   Mon May 6 13:05:38 2013 -0700

    refactored crittermanager