added javadoc explaining the venue classes