updated documentation
spread out an overly complex line and added documentation to explain why the case exists