add javadocs for internal classes

[emdobrin]

• for cross-project development and debugging, include the option of generating javadocs for internal classes
• standardize and clean-up docs to markdown/html format