removed javadoc warnings
using the WriteableToStorage interface for javadoc re-use
added javadoc
fixed javadoc warnings