Moved relevant documentation from showcase to javadoc and improved where
necessary. In the future, the showcase will extract the documentation
directly from javadoc.