adding initial javadocs (no content yet, just the initial skeleton)