updated api mockups for javadoc/sources story