added sample resources, fixed javadoc and warnings