start example, add to javadoc and to the readme