add a little bit more documentation on limits