added documentation about sentinel element

This is a separate pull request from the tests because you might be able to do a better job with the documentation on the need for a sentinel element. but if you like this go ahead and pull it.