added Javadocs to service interfaces